A read-only window into Claude Code's task chaos
It turns Claude Code's hidden JSON task files into a live browser dashboard so you can see what the agent is doing without reading terminal scrollback.

What it does
The tool monitors Claude Code’s local task directory and renders a persistent browser dashboard from the JSON files inside. You watch tasks shift status in real time, trace dependency chains, and switch between a Kanban board and a Gantt-style timeline. It is strictly read-only: Claude drives the state machine, and the viewer just broadcasts what is happening.
The interesting bit
Most dashboards beg you to micromanage; this one enforces a strict “observation over control” philosophy. It streams filesystem changes to the browser via Server-Sent Events, so the board updates instantly without polling, yet it refuses to let you edit task status or descriptions—Claude Code remains the single source of truth.
Key highlights
- Live activity feed across every session via Server-Sent Events
- Desktop notifications and a two-tone chime when tasks complete
- Gantt-style timeline with an auto-scaling axis (seconds to days)
- Visual dependency mapping for
blockedBy/blocksrelationships - Fuzzy search across session names, descriptions, and project paths
- Auto-archives sessions idle for more than seven days
Caveats
- Export and advanced filtering by date or status are still on the roadmap.
- Desktop alerts and the audio chime require manually granting browser notification permission.
Verdict
Grab it if you run multiple Claude Code sessions and want a heads-up display without hovering over terminal scrollback. Pass if a single shell pane already gives you everything you need.
Frequently asked
- What is L1AD/claude-task-viewer?
- It turns Claude Code's hidden JSON task files into a live browser dashboard so you can see what the agent is doing without reading terminal scrollback.
- Is claude-task-viewer open source?
- Yes — L1AD/claude-task-viewer is open source, released under the MIT license.
- What language is claude-task-viewer written in?
- L1AD/claude-task-viewer is primarily written in HTML.
- How popular is claude-task-viewer?
- L1AD/claude-task-viewer has 659 stars on GitHub.
- Where can I find claude-task-viewer?
- L1AD/claude-task-viewer is on GitHub at https://github.com/L1AD/claude-task-viewer.