← all repositories
L1AD/claude-task-viewer

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.

claude-task-viewer
Not currently ranked — collecting fresh signals.
star history

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/blocks relationships
  • 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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.