claude-code-kanban 2.0.1 → 2.1.0-rc.2

package/README.md

@@ -87,6 +87,38 @@ Claude Code writes task files to `~/.claude/tasks/` and conversation logs to `~/
 | `TeammateIdle` | Idle detection for team member agents |
 | `PostToolUse` | Waiting-for-user detection (permission prompts, AskUserQuestion) |
 
+## Context Window Monitoring
+
+Track real-time context window usage for each Claude Code session directly in the dashboard sidebar and detail panel.
+
+### Setup
+
+The installer copies `context-status.sh` alongside the agent hooks:
+
+```bash
+npx claude-code-kanban --install
+```
+
+Then add it to your statusline in `~/.claude/settings.json`:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "~/.claude/hooks/context-status.sh | npx -y ccstatusline@latest",
+    "padding": 0
+  }
+}
+```
+
+The script pipes through — your existing statusline still works. It just writes a snapshot to `~/.claude/context-status/{sessionId}.json` on each update.
+
+### What you get
+
+- **Sidebar bar** — compact context usage bar per session with color thresholds (green → yellow → orange → red) and a 200K token marker
+- **Detail panel** — input/output token breakdown, cache read tokens, cost, duration, API time, lines added/removed, and model name
+- Only shown for active or pinned sessions
+
 ## FAQ
 
 **Does this control Claude?**

package/hooks/context-status.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Statusline spy: writes raw context data for kanban dashboard, passes input through
+# Layout: ~/.claude/context-status/{sessionId}.json
+#
+# Usage: pipe before your statusline command:
+#   "command": "~/.claude/hooks/context-status.sh | npx -y ccstatusline@latest"
+
+INPUT=$(cat)
+
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // ""')
+if [ -n "$SESSION_ID" ]; then
+  DIR="$HOME/.claude/context-status"
+  mkdir -p "$DIR"
+  echo "$INPUT" > "$DIR/$SESSION_ID.json"
+fi
+
+# Pass through original input for downstream statusline
+echo "$INPUT"

package/install.js

@@ -11,6 +11,8 @@ const HOOKS_DIR = path.join(CLAUDE_DIR, 'hooks');
 const SETTINGS_PATH = path.join(CLAUDE_DIR, 'settings.json');
 const HOOK_SCRIPT_DEST = path.join(HOOKS_DIR, 'agent-spy.sh');
 const HOOK_SCRIPT_SRC = path.join(__dirname, 'hooks', 'agent-spy.sh');
+const CTX_SCRIPT_DEST = path.join(HOOKS_DIR, 'context-status.sh');
+const CTX_SCRIPT_SRC = path.join(__dirname, 'hooks', 'context-status.sh');
 const AGENT_ACTIVITY_DIR = path.join(CLAUDE_DIR, 'agent-activity');
 
 const HOOK_COMMAND = '~/.claude/hooks/agent-spy.sh';
@@ -52,36 +54,42 @@ async function runInstall() {
     console.log(yellow('⚠ not found — hook script requires jq for JSON parsing'));
   }
 
-  // 2. Hook script
-  console.log(`\n  Hook script: ${dim(HOOK_SCRIPT_DEST)}`);
-  let hookInstalled = false;
-  if (fs.existsSync(HOOK_SCRIPT_DEST)) {
-    const existing = fs.readFileSync(HOOK_SCRIPT_DEST, 'utf8');
-    const bundled = fs.readFileSync(HOOK_SCRIPT_SRC, 'utf8');
-    if (existing === bundled) {
-      console.log(`    ${green('✓')} Up to date`);
-      hookInstalled = true;
-    } else {
+  async function installScript(label, src, dest) {
+    console.log(`\n  ${label}: ${dim(dest)}`);
+    if (fs.existsSync(dest)) {
+      const existing = fs.readFileSync(dest, 'utf8');
+      const bundled = fs.readFileSync(src, 'utf8');
+      if (existing === bundled) {
+        console.log(`    ${green('✓')} Up to date`);
+        return true;
+      }
       if (await prompt(`    Different version found. Update? [Y/n] `)) {
         fs.mkdirSync(HOOKS_DIR, { recursive: true });
-        fs.copyFileSync(HOOK_SCRIPT_SRC, HOOK_SCRIPT_DEST);
-        try { fs.chmodSync(HOOK_SCRIPT_DEST, 0o755); } catch {}
+        fs.copyFileSync(src, dest);
+        try { fs.chmodSync(dest, 0o755); } catch {}
         console.log(`    ${green('✓')} Updated`);
-        hookInstalled = true;
-      } else {
-        console.log(`    ${dim('Skipped')}`);
+        return true;
       }
+      console.log(`    ${dim('Skipped')}`);
+      return false;
     }
-  } else {
     if (await prompt(`    Not found. Install? [Y/n] `)) {
       fs.mkdirSync(HOOKS_DIR, { recursive: true });
-      fs.copyFileSync(HOOK_SCRIPT_SRC, HOOK_SCRIPT_DEST);
-      try { fs.chmodSync(HOOK_SCRIPT_DEST, 0o755); } catch {}
+      fs.copyFileSync(src, dest);
+      try { fs.chmodSync(dest, 0o755); } catch {}
       console.log(`    ${green('✓')} Installed and set executable`);
-      hookInstalled = true;
-    } else {
-      console.log(`    ${dim('Skipped')}`);
+      return true;
     }
+    console.log(`    ${dim('Skipped')}`);
+    return false;
+  }
+
+  // 2. Hook scripts
+  const hookInstalled = await installScript('Hook script', HOOK_SCRIPT_SRC, HOOK_SCRIPT_DEST);
+  const ctxInstalled = await installScript('Context spy', CTX_SCRIPT_SRC, CTX_SCRIPT_DEST);
+  if (ctxInstalled) {
+    console.log(`\n    ${yellow('To enable context tracking, pipe it before your statusline:')}`);
+    console.log(`    ${dim('"statusLine": { "command": "~/.claude/hooks/context-status.sh | <your-statusline>" }')}`);
   }
 
   // 3. Settings.json
@@ -178,13 +186,19 @@ async function runUninstall() {
     console.log(`  Settings: ${dim('No settings.json found')}`);
   }
 
-  // 2. Remove hook script
+  // 2. Remove hook scripts
   if (fs.existsSync(HOOK_SCRIPT_DEST)) {
     fs.unlinkSync(HOOK_SCRIPT_DEST);
     console.log(`  Hook script: ${green('✓')} Removed`);
   } else {
     console.log(`  Hook script: ${dim('Not found')}`);
   }
+  if (fs.existsSync(CTX_SCRIPT_DEST)) {
+    fs.unlinkSync(CTX_SCRIPT_DEST);
+    console.log(`  Context spy: ${green('✓')} Removed`);
+  } else {
+    console.log(`  Context spy: ${dim('Not found')}`);
+  }
 
   // 3. Optionally remove agent-activity data
   if (fs.existsSync(AGENT_ACTIVITY_DIR)) {

package/lib/parsers.js

@@ -287,6 +287,11 @@ function readRecentMessages(jsonlPath, limit = 10) {
                       return text;
                     }).join('\n\n');
                   }
+                  else if (inp.plan) {
+                    const titleMatch = inp.plan.match(/^#\s+(.+)/m);
+                    detail = titleMatch ? titleMatch[1] : 'Plan';
+                    fullDetail = detail;
+                  }
                   else if (inp.description) { detail = inp.description; fullDetail = inp.description; }
                 }
                 const params = {};
@@ -343,6 +348,9 @@ function readRecentMessages(jsonlPath, limit = 10) {
                     if (inp.model) params.model = inp.model;
                     if (inp.run_in_background) params.background = true;
                     if (inp.isolation) params.isolation = inp.isolation;
+                  } else if (block.name === 'ExitPlanMode') {
+                    if (inp.plan) params.plan = inp.plan;
+                    if (inp.planFilePath) params.planFilePath = inp.planFilePath;
                   }
                 }
                 const msg = {
@@ -367,6 +375,49 @@ function readRecentMessages(jsonlPath, limit = 10) {
           } else if (obj.type === 'user' && obj.message?.role === 'user' && !obj.isMeta) {
             if (typeof obj.message.content === 'string') {
               const t = obj.message.content;
+              const tmMatch = t.match(/<teammate-message\s+([^>]*)>([\s\S]*?)<\/teammate-message>/);
+              if (tmMatch) {
+                const attrs = tmMatch[1];
+                const body = tmMatch[2].trim();
+                const getAttr = (name) => (attrs.match(new RegExp(name + '="([^"]*)"')) || [])[1] || null;
+                const tid = getAttr('teammate_id');
+                const color = getAttr('color');
+                const summary = getAttr('summary');
+                let protocol = null;
+                try {
+                  const j = JSON.parse(body);
+                  if (j.type) protocol = j;
+                } catch (_) {}
+                const isIdle = protocol?.type === 'idle_notification';
+                const isProtocol = !!protocol;
+                let protocolLabel = null;
+                if (protocol) {
+                  switch (protocol.type) {
+                    case 'idle_notification': protocolLabel = protocol.idleReason || 'idle'; break;
+                    case 'task_assignment': protocolLabel = `assigned #${protocol.taskId}: ${protocol.subject || ''}`; break;
+                    case 'shutdown_request': protocolLabel = `shutdown: ${protocol.reason || 'requested'}`; break;
+                    case 'shutdown_response': protocolLabel = protocol.approve ? 'shutdown approved' : `shutdown rejected: ${protocol.reason || ''}`; break;
+                    case 'plan_approval_request': protocolLabel = 'plan approval requested'; break;
+                    case 'plan_approval_response': protocolLabel = protocol.approve ? 'plan approved' : `plan rejected: ${protocol.feedback || ''}`; break;
+                    default: protocolLabel = protocol.type; break;
+                  }
+                }
+                const truncated = !isProtocol && body.length > 500;
+                messages.push({
+                  type: 'teammate',
+                  teammateId: tid,
+                  color,
+                  summary,
+                  isIdle,
+                  isProtocol,
+                  protocolType: protocol?.type || null,
+                  protocolLabel,
+                  text: isProtocol ? null : (truncated ? body.slice(0, 500) + '...' : body),
+                  fullText: isProtocol ? null : (truncated ? body : null),
+                  timestamp: obj.timestamp
+                });
+                continue;
+              }
               const sysLabel = getSystemMessageLabel(t);
               if (sysLabel === '__skip__') continue;
               const uTruncated = t.length > 500;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kanban",
-  "version": "2.0.1",
+  "version": "2.1.0-rc.2",
   "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
   "main": "server.js",
   "bin": {
@@ -11,7 +11,8 @@
     "dev": "node server.js --open",
     "test": "node --test test/contracts.test.js",
     "test:hooks": "bash tests/test-agent-spy.sh",
-    "validate:schemas": "node test/validate-live-schemas.js"
+    "validate:schemas": "node test/validate-live-schemas.js",
+    "prepare": "husky"
   },
   "repository": {
     "type": "git",
@@ -45,11 +46,13 @@
     "server.js",
     "install.js",
     "hooks/agent-spy.sh",
+    "hooks/context-status.sh",
     "lib/**/*",
     "public/**/*"
   ],
   "devDependencies": {
     "ajv": "^8.18.0",
-    "ajv-formats": "^3.0.1"
+    "ajv-formats": "^3.0.1",
+    "husky": "^9.1.7"
   }
 }