claude-code-kanban 1.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,144 @@
+# 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.
+
+![Dark mode](screenshot-dark-v2.png)
+
+![Light mode](screenshot-light-v2.png)
+
+## 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
+- **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
+
+### Cleanup Operations
+- **Delete tasks** — Remove tasks with the delete button or press `D` (includes safety checks for dependencies)
+- **Bulk delete** — Delete all tasks in a session at once
+
+### Session Management
+View and organize your Claude Code sessions:
+- **Session discovery** — Automatically finds all sessions in `~/.claude/tasks/` and `~/.claude/projects/`
+- **View project paths** — See the full filesystem path for each project
+- **Fuzzy search** — Search across session names, task descriptions, and project paths with instant filtering
+- **Session limits** — Filter to show only active sessions or a specific number of recent sessions
+
+### Keyboard Shortcuts
+- `?` — Show help with all keyboard shortcuts
+- `D` — Delete the currently selected task (with confirmation and dependency checking)
+- `Esc` — Close detail panel or modals
+
+## Installation
+
+### Quick start
+
+```bash
+npx claude-task-viewer
+```
+
+Open http://localhost:3456
+
+### From source
+
+```bash
+git clone https://github.com/L1AD/claude-task-viewer.git
+cd claude-task-viewer
+npm install
+npm start
+```
+
+## How It Works
+
+Claude Code stores tasks in `~/.claude/tasks/`. Each session has its own folder:
+
+```
+~/.claude/tasks/
+  └── {session-uuid}/
+      ├── 1.json
+      ├── 2.json
+      └── ...
+```
+
+The viewer watches this directory and pushes updates via Server-Sent Events. Changes appear instantly — no polling, no refresh needed.
+
+## Task Structure
+
+```json
+{
+  "id": "1",
+  "subject": "Implement user authentication",
+  "description": "Add JWT-based auth with refresh tokens",
+  "activeForm": "Setting up auth middleware",
+  "status": "in_progress",
+  "blocks": ["2", "3"],
+  "blockedBy": []
+}
+```
+
+- `activeForm` — What Claude is doing right now (shown in Live Updates)
+- `blocks` / `blockedBy` — Task dependency relationships
+
+## Configuration
+
+```bash
+# Custom port
+PORT=8080 npx claude-task-viewer
+
+# Open browser automatically
+npx claude-task-viewer --open
+
+# Use a different Claude config directory (for multiple accounts)
+npx claude-task-viewer --dir=~/.claude-work
+```
+
+## API
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/sessions` | GET | List all sessions with task counts |
+| `/api/sessions/:id` | GET | Get all tasks for a session |
+| `/api/tasks/all` | GET | Get all tasks across all sessions |
+| `/api/tasks/:session/:task` | DELETE | Delete a task (checks dependencies) |
+| `/api/tasks/:session/:task/note` | POST | Add a note to a task |
+| `/api/events` | GET | SSE stream for live updates |
+
+## Design Philosophy
+
+**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.
+
+**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.
+
+## Roadmap
+
+### ✅ Completed
+- **Real-time observation** — Live updates feed showing what Claude is doing across all sessions
+- **Task dependencies** — Visualise blockedBy/blocks relationships
+- **Task deletion** — Delete tasks with dependency checking
+- **Keyboard shortcuts** — ?, D, Esc for quick actions
+- **Session discovery** — Automatic detection of all Claude Code sessions
+- **Search** — Search across sessions and tasks
+
+### 🚧 Planned
+- **Enhanced search & filter** — Filter by status, dependencies, date ranges
+- **Session grouping** — Group sessions by project or time period
+- **Task timeline** — See when tasks were created and completed
+- **Export** — Export session data for analysis or reporting
+- **Desktop notifications** — Optional notifications when tasks complete
+
+[Open an issue](https://github.com/L1AD/claude-task-viewer/issues) with ideas or feedback.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "claude-code-kanban",
+  "version": "1.9.0",
+  "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
+  "main": "server.js",
+  "bin": {
+    "claude-task-viewer": "./server.js"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node server.js --open"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NikiforovAll/claude-task-viewer.git"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "tasks",
+    "todo",
+    "kanban",
+    "viewer",
+    "agent-teams"
+  ],
+  "author": "NikiforovAll",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/NikiforovAll/claude-task-viewer/issues"
+  },
+  "homepage": "https://github.com/NikiforovAll/claude-task-viewer#readme",
+  "dependencies": {
+    "chokidar": "^3.5.3",
+    "express": "^4.18.2",
+    "open": "^10.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "server.js",
+    "public/**/*"
+  ]
+}