@cwim/kanban 1.1.0 → 1.1.2

package/README.md

@@ -9,7 +9,7 @@ CWIM Kanban is a complementary package to CWIM (Context Window Intelligence Mana
 - **MCP Server** — Exposes Kanban operations as Claude Code tools (`task_create`, `task_move`, `task_list`, etc.)
 - **Web Dashboard** — A clean, dark-themed Kanban board served locally at `http://localhost:3456`
 - **CLI** — Full command-line interface for managing tasks outside of Claude
-- **Local JSON Storage** — All data stored in `~/.kanban/tasks.json`, no cloud or database needed
+- **Local JSON Storage** — Per-session task storage in `~/.kanban/sessions/`, no cloud or database needed
 
 As Claude works through complex multi-step tasks, it can create cards, move them across columns, and you watch progress unfold in real time on the board.
 
@@ -50,11 +50,41 @@ Once connected, Claude can use these tools during your sessions:
 | `task_update` | Edit task title, description, tags |
 | `task_move` | Move a task to another column |
 | `task_delete` | Remove a task |
-| `task_list` | List all tasks (optionally filtered) |
+| `task_list` | List all tasks in current session (optionally filtered) |
 | `task_get` | Show details of a specific task |
+| `session_list` | List all available sessions |
+| `session_switch` | Switch to a different session |
 
 Claude will automatically detect the tools and use them to track progress on complex tasks. Tasks created via MCP are tagged with source "claude" so you can distinguish them from manually created ones.
 
+## Session Management
+
+CWIM Kanban supports **full session isolation** — each Claude Code project gets its own Kanban board:
+
+- Sessions are auto-detected from `~/.claude/projects/`
+- Each session has isolated task storage
+- Switch between sessions via dashboard dropdown, CLI, or MCP
+- "Independent Mode" available when no Claude session is active
+
+### Switching Sessions
+
+**Dashboard:** Click the session name in the header center to open the dropdown selector.
+
+**CLI:**
+```bash
+# List all available sessions
+kanban sessions
+
+# Switch to a different session
+kanban switch my-project
+```
+
+**MCP:**
+```
+session_list    # Show available sessions
+session_switch  # Change active session
+```
+
 ## CLI Commands
 
 ### `kanban` (default) — Launch Dashboard
@@ -77,6 +107,20 @@ kanban --no-open
 kanban mcp
 ```
 
+### `kanban sessions` — List Sessions
+
+```bash
+# Show all available sessions with active indicator
+kanban sessions
+```
+
+### `kanban switch` — Change Session
+
+```bash
+# Switch to a specific session
+kanban switch my-project
+```
+
 ### `kanban add` — Create Task
 
 ```bash
@@ -93,7 +137,7 @@ kanban add "Write tests" -s in-progress
 ### `kanban list` — List Tasks
 
 ```bash
-# All tasks
+# All tasks in current session
 kanban list
 
 # Filter by status
@@ -139,7 +183,7 @@ kanban remove tf-abc123
 ### `kanban init` — Initialize Storage
 
 ```bash
-# Creates ~/.kanban/ directory and empty tasks.json
+# Creates ~/.kanban/ directory structure
 kanban init
 ```
 
@@ -148,7 +192,8 @@ kanban init
 - **Real-time updates** — Board refreshes every 2 seconds, showing changes as Claude moves tasks
 - **4 columns** — To Do, In Progress, Done, Blocked
 - **Visual indicators** — Color-coded borders, pulsing LIVE badge, flash animation on task moves
-- **Session linking** — Auto-detects active Claude Code session and shows it in the header
+- **Session switching** — Dropdown in header to browse and switch between Claude projects
+- **Session isolation** — Each project has its own independent task board
 - **Tag support** — Tasks show tags as badges for quick categorization
 - **Source tracking** — Distinguishes between Claude-created and manually-created tasks
 - **Keyboard shortcuts** — `r` to refresh, `1-4` to filter columns
@@ -156,7 +201,21 @@ kanban init
 
 ## Data Storage
 
-All data is stored locally in `~/.kanban/tasks.json`:
+All data is stored locally in `~/.kanban/sessions/{session-name}/tasks.json`:
+
+```
+~/.kanban/
+├── sessions/
+│   ├── my-project/
+│   │   └── tasks.json
+│   ├── another-project/
+│   │   └── tasks.json
+│   └── independent/
+│       └── tasks.json
+└── active-session.json
+```
+
+Each session's tasks.json:
 
 ```json
 {
@@ -183,7 +242,7 @@ All data is stored locally in `~/.kanban/tasks.json`:
 
 - **Local-first** — No cloud services, no accounts, no network required
 - **Human-readable** — JSON format you can edit directly if needed
-- **Session-aware** — Links tasks to Claude Code sessions when available
+- **Session-aware** — Each Claude Code project gets its own isolated board
 - **Portable** — Back up or version-control your `~/.kanban/` directory
 
 ## Programmatic API
@@ -191,9 +250,9 @@ All data is stored locally in `~/.kanban/tasks.json`:
 Core functions are exported for custom integrations:
 
 ```typescript
-import { createTask, listTasks, moveTask, getAllData } from '@cwim/kanban';
+import { createTask, listTasks, moveTask, getAllData, listAllSessions, setActiveSession } from '@cwim/kanban';
 
-// Create a task programmatically
+// Create a task in current session
 const task = await createTask({
   title: 'My task',
   description: 'Optional details',
@@ -202,7 +261,13 @@ const task = await createTask({
   source: 'manual'
 });
 
-// Get all data
+// List all available sessions
+const sessions = await listAllSessions();
+
+// Switch active session
+await setActiveSession('my-project');
+
+// Get all data for current session
 const data = await getAllData();
 console.log(data.tasks);
 ```
@@ -212,15 +277,17 @@ See `src/index.ts` for all available exports.
 ## Architecture
 
 ```
-Claude Code → MCP Server (stdio) → tasks.json ← HTTP Server ← Dashboard UI
+Claude Code → MCP Server (stdio) → session tasks.json ← HTTP Server ← Dashboard UI
                 ↑                                              ↑
            task_create, move, etc.                    polling /api/tasks
+                                                        + /api/sessions
 ```
 
 - **MCP Server** and **HTTP Server** are separate processes
-- They communicate through the shared JSON file, not sockets or IPC
-- The dashboard polls `/api/tasks` every 2 seconds
+- They communicate through per-session JSON files, not sockets or IPC
+- The dashboard polls `/api/tasks` and `/api/sessions` every 2 seconds
 - All mutations go through the MCP tools or CLI commands
+- Session switching is persisted in `~/.kanban/active-session.json`
 
 ## Requirements
 

package/dashboard/dist/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>TaskFlow Kanban</title>
+    <title>Kanban</title>
     <script type="module" crossorigin src="/assets/index-BjmAGTF2.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-CfRsoq4J.css">
   </head>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cwim/kanban",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Minimal Kanban task tracking with MCP integration for Claude Code",
   "type": "module",
   "main": "dist/index.js",
@@ -32,6 +32,9 @@
     "cwim"
   ],
   "author": "Chiheb Nabil",
+  "repository": {
+    "url": "https://github.com/cwimhq/kanban.git"
+  },
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",