README
Claude Task Viewer
A real-time Kanban board for observing Claude Code tasks. See what Claude is working on, track dependencies between tasks, and manage task cleanup and priority.
Why Use This?
When Claude Code breaks down complex work into tasks, you get visibility into its thinking — but only in the terminal. Claude Task Viewer gives you a persistent, visual dashboard to:
- See the big picture — All your sessions and tasks in one place
- Know what's happening now — Live Updates show exactly what Claude is doing across all sessions
- Understand task dependencies — See which tasks are blocked and what's holding them up
- Get notified — Desktop notifications and sound chime when tasks complete
- Visualise timing — Timeline view shows task durations as a Gantt-style chart
- Stay organised — Stale sessions auto-archive to keep the sidebar clean
- Clean up completed work — Delete tasks when no longer needed (with dependency checking)
Key Features
Observation-Focused Design
Claude Code controls task state — the viewer shows you what's happening:
- Real-time status — See tasks move through Pending → In Progress → Completed as Claude works
- Active session detection — Indicators show which sessions have in-progress tasks
- Task dependencies — Visualise blockedBy/blocks relationships to understand the critical path
- Live activity feed — Real-time stream of all in-progress tasks across every session