claude-task-viewer 1.7.1 → 1.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +49 -28
  2. package/package.json +1 -1
  3. package/public/index.html +1053 -40
  4. package/server.js +142 -68
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Claude Task Viewer
2
2
 
3
- A real-time Kanban board for monitoring Claude Code tasks. See what Claude is working on, track dependencies between tasks, and add notes that Claude can read.
3
+ 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.
4
4
 
5
5
  ![Dark mode](screenshot-dark-v2.png)
6
6
 
@@ -13,27 +13,32 @@ When Claude Code breaks down complex work into tasks, you get visibility into it
13
13
  - **See the big picture** — All your sessions and tasks in one place
14
14
  - **Know what's happening now** — Live Updates show exactly what Claude is doing across all sessions
15
15
  - **Understand task dependencies** — See which tasks are blocked and what's holding them up
16
- - **Collaborate with Claude** — Add notes to tasks that Claude reads when it picks them up
16
+ - **Clean up completed work** — Delete tasks when no longer needed (with dependency checking)
17
17
 
18
18
  ## Key Features
19
19
 
20
- ### Live Updates
21
- Real-time feed of all in-progress tasks across every session. See what Claude is actively working on without switching terminals. Each update shows the current action and which session it belongs to.
20
+ ### Observation-Focused Design
21
+ Claude Code controls task state — the viewer shows you what's happening:
22
+ - **Real-time status** — See tasks move through Pending → In Progress → Completed as Claude works
23
+ - **Active session detection** — Indicators show which sessions have in-progress tasks
24
+ - **Task dependencies** — Visualise blockedBy/blocks relationships to understand the critical path
25
+ - **Live activity feed** — Real-time stream of all in-progress tasks across every session
22
26
 
23
- ### Task Dependencies
24
- Tasks can block other tasks. The viewer shows these relationships clearly — blocked tasks display what they're waiting on, and you can trace dependency chains to understand the critical path. No more wondering why a task hasn't started.
25
-
26
- ### Notes
27
- Add context to any task. Your notes are appended to the task description, so Claude sees them when it reads the task. Use this to clarify requirements, add constraints, or redirect work — all without interrupting Claude's flow.
28
-
29
- ### Search
30
- Find tasks instantly. Type in the search box to filter across all columns by subject or description. Case-insensitive, real-time results.
31
-
32
- ### Project Filtering
33
- Filter tasks by project using the dropdown. Working on multiple codebases? See only what's relevant. Combine with the session filter to show just active sessions for a specific project.
27
+ ### Cleanup Operations
28
+ - **Delete tasks** — Remove tasks with the delete button or press `D` (includes safety checks for dependencies)
29
+ - **Bulk delete** — Delete all tasks in a session at once
34
30
 
35
31
  ### Session Management
36
- Browse all your Claude Code sessions with progress indicators. Filter to active sessions only, or show everything. Each session shows completion percentage.
32
+ View and organize your Claude Code sessions:
33
+ - **Session discovery** — Automatically finds all sessions in `~/.claude/tasks/` and `~/.claude/projects/`
34
+ - **View project paths** — See the full filesystem path for each project
35
+ - **Fuzzy search** — Search across session names, task descriptions, and project paths with instant filtering
36
+ - **Session limits** — Filter to show only active sessions or a specific number of recent sessions
37
+
38
+ ### Keyboard Shortcuts
39
+ - `?` — Show help with all keyboard shortcuts
40
+ - `D` — Delete the currently selected task (with confirmation and dependency checking)
41
+ - `Esc` — Close detail panel or modals
37
42
 
38
43
  ## Installation
39
44
 
@@ -100,21 +105,37 @@ npx claude-task-viewer --dir=~/.claude-work
100
105
 
101
106
  ## API
102
107
 
103
- | Endpoint | Description |
104
- |----------|-------------|
105
- | `GET /api/sessions` | List all sessions with task counts |
106
- | `GET /api/sessions/:id` | Get all tasks for a session |
107
- | `GET /api/tasks/all` | Get all tasks across all sessions |
108
- | `POST /api/tasks/:session/:task/note` | Add a note to a task |
109
- | `GET /api/events` | SSE stream for live updates |
108
+ | Endpoint | Method | Description |
109
+ |----------|--------|-------------|
110
+ | `/api/sessions` | GET | List all sessions with task counts |
111
+ | `/api/sessions/:id` | GET | Get all tasks for a session |
112
+ | `/api/tasks/all` | GET | Get all tasks across all sessions |
113
+ | `/api/tasks/:session/:task` | DELETE | Delete a task (checks dependencies) |
114
+ | `/api/tasks/:session/:task/note` | POST | Add a note to a task |
115
+ | `/api/events` | GET | SSE stream for live updates |
116
+
117
+ ## Design Philosophy
118
+
119
+ **Observation over Control**: Claude Code owns task state. The task viewer's job is to show you what Claude is doing, not to direct it. This keeps the viewer in sync with reality and prevents confusion about whether a task's status reflects what Claude is actually doing or just human intent.
120
+
121
+ **Limited interaction:** You can delete tasks and add notes, but task status, subject, and description reflect Claude's actual work and can only be changed by Claude Code itself.
110
122
 
111
123
  ## Roadmap
112
124
 
113
- - **Shared task lists** — View tasks shared across multiple Claude Code sessions and subagents
114
- - **Task creation** — Create tasks from the viewer that Claude picks up
115
- - **CLI integration** — `claude-task-viewer add "Fix the bug"`
116
- - **Desktop notifications** — Know when tasks complete
117
- - **Export** — Push tasks to Linear, GitHub Issues, or Jira
125
+ ### ✅ Completed
126
+ - **Real-time observation** — Live updates feed showing what Claude is doing across all sessions
127
+ - **Task dependencies** — Visualise blockedBy/blocks relationships
128
+ - **Task deletion** — Delete tasks with dependency checking
129
+ - **Keyboard shortcuts** — ?, D, Esc for quick actions
130
+ - **Session discovery** — Automatic detection of all Claude Code sessions
131
+ - **Search** — Search across sessions and tasks
132
+
133
+ ### 🚧 Planned
134
+ - **Enhanced search & filter** — Filter by status, dependencies, date ranges
135
+ - **Session grouping** — Group sessions by project or time period
136
+ - **Task timeline** — See when tasks were created and completed
137
+ - **Export** — Export session data for analysis or reporting
138
+ - **Desktop notifications** — Optional notifications when tasks complete
118
139
 
119
140
  [Open an issue](https://github.com/L1AD/claude-task-viewer/issues) with ideas or feedback.
120
141
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-task-viewer",
3
- "version": "1.7.1",
3
+ "version": "1.8.1",
4
4
  "description": "A web-based Kanban board for viewing Claude Code tasks",
5
5
  "main": "server.js",
6
6
  "bin": {