claude-code-kanban 3.5.1 → 3.5.3

package/cli.js

@@ -42,6 +42,16 @@ const COMMANDS = {
         },
         run: runSessionViewCli,
       },
+      pin: {
+        summary: 'Pin (or unpin) a session in the sidebar of connected browser tabs',
+        usage: 'claude-code-kanban session pin <id> [--sticky] [--unpin]',
+        flags: {
+          '<id>': 'Full session id, or a unique prefix',
+          '--sticky': 'Set sticky state (always shown, top of list)',
+          '--unpin': 'Clear pin/sticky state',
+        },
+        run: runSessionPinCli,
+      },
       peek: {
         summary: 'Show the last N messages from a session',
         usage: 'claude-code-kanban session peek <id> [--limit <n>] [--json]',
@@ -361,6 +371,31 @@ async function runSessionOpenCli(args) {
   } catch (e) { reportCliError(e); return 1; }
 }
 
+async function runSessionPinCli(args) {
+  const idArg = args.find(a => !a.startsWith('--'));
+  if (!idArg) {
+    printLeafHelp('session pin', COMMANDS.session.verbs.pin);
+    return 1;
+  }
+  const state = args.includes('--unpin') ? 'none' : args.includes('--sticky') ? 'sticky' : 'pinned';
+  const resolved = await resolveSessionByIdOrPrefix(idArg);
+  if (!resolved) return 1;
+  try {
+    const res = await cliFetch('/api/session/pin', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id: resolved.id, state })
+    });
+    if (!res.ok) {
+      console.error(`Pin failed (${res.status}): ${await res.text()}`);
+      return 1;
+    }
+    const label = state === 'none' ? 'unpinned' : state;
+    console.log(`Session ${label}: ${resolved.id}${resolved.customTitle ? ` (${resolved.customTitle})` : ''}`);
+    return 0;
+  } catch (e) { reportCliError(e); return 1; }
+}
+
 async function runSessionViewCli(args) {
   const idArg = args.find(a => !a.startsWith('--'));
   if (!idArg) {

package/lib/parsers.js

@@ -182,10 +182,22 @@ function scrapeScalarFromBlob(blob, re) {
   try { return JSON.parse(`"${m[1]}"`); } catch (e) { return null; }
 }
 
+const sessionInfoCache = new Map();
+const SESSION_INFO_CACHE_MAX = 2000;
+
 function readSessionInfoFromJsonl(jsonlPath) {
   const result = { slug: null, projectPath: null, cwd: null, gitBranch: null, customTitle: null };
   let stat;
   let fd;
+  try {
+    stat = statSync(jsonlPath);
+    const cached = sessionInfoCache.get(jsonlPath);
+    if (cached && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) {
+      return { ...cached.result, customTitle: readCustomTitle(jsonlPath, stat) };
+    }
+  } catch (_) {
+    return result;
+  }
   // State shared across head-chunk parse, leftover flush, and tail parse.
   let lastCwdFromHead = null;
   const applyLine = (line) => {
@@ -200,7 +212,6 @@ function readSessionInfoFromJsonl(jsonlPath) {
     } catch (e) {}
   };
   try {
-    stat = statSync(jsonlPath);
     fd = fs.openSync(jsonlPath, 'r');
     const CHUNK_SIZE = 16384;
     const TAIL_SIZE = 16384;
@@ -264,6 +275,14 @@ function readSessionInfoFromJsonl(jsonlPath) {
     if (fd !== undefined) { try { fs.closeSync(fd); } catch (e) {} }
   }
 
+  if (stat) {
+    const { customTitle: _ct, ...rest } = result;
+    sessionInfoCache.set(jsonlPath, { mtimeMs: stat.mtimeMs, size: stat.size, result: rest });
+    if (sessionInfoCache.size > SESSION_INFO_CACHE_MAX) {
+      const firstKey = sessionInfoCache.keys().next().value;
+      sessionInfoCache.delete(firstKey);
+    }
+  }
   result.customTitle = readCustomTitle(jsonlPath, stat);
   return result;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kanban",
-  "version": "3.5.1",
+  "version": "3.5.3",
   "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
   "main": "server.js",
   "bin": {

package/plugin/plugins/claude-code-kanban/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "claude-code-kanban",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Agent activity tracking for claude-code-kanban dashboard"
 }

package/plugin/plugins/claude-code-kanban/skills/kanban/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: kanban
-description: Drive the claude-code-kanban browser dashboard from this Claude session. Use this skill when the user mentions "kanban" together with "session" — e.g. "open this session in kanban", "show kanban", "focus current session in kanban", "preview this file in kanban", or asks to peek/view a kanban session.
+description: Drive the claude-code-kanban browser dashboard from this Claude session. Use this skill when the user mentions "kanban" together with "session" — e.g. "open this session in kanban", "show kanban", "focus current session in kanban", "pin/unpin a session in kanban", "preview this file in kanban", or asks to peek/view a kanban session.
 compatibility: Requires the `claude-code-kanban` CLI on PATH and the server running locally (default port 3456).
 ---
 
@@ -22,6 +22,20 @@ claude-code-kanban session open ${CLAUDE_SESSION_ID}
 
 Trigger phrases: "show this session in kanban", "focus current session", "open in kanban".
 
+## Pin the current session in kanban
+
+Pins the active Claude session in the sidebar so it stays visible regardless of filters. Three states: `pinned` (default), `sticky` (always at the top), or cleared via `--unpin`.
+
+```bash
+claude-code-kanban session pin ${CLAUDE_SESSION_ID}            # pin
+claude-code-kanban session pin ${CLAUDE_SESSION_ID} --sticky   # sticky at top
+claude-code-kanban session pin ${CLAUDE_SESSION_ID} --unpin    # clear
+```
+
+State applies to every connected browser tab (broadcast via SSE) and persists in each tab's localStorage. With no tabs open the command is a no-op.
+
+Trigger phrases: "pin this session", "pin in kanban", "make this session sticky", "unpin session".
+
 ## Preview a file in kanban
 
 Opens a markdown file in the preview modal:

package/public/app.js

@@ -1335,6 +1335,19 @@ function toggleSessionSticky(sessionId) {
   renderSessions();
 }
 
+function handleSessionPinEvent({ id, state }) {
+  if (!id) return;
+  pinnedSessionIds.delete(id);
+  stickySessionIds.delete(id);
+  if (state === 'pinned') pinnedSessionIds.add(id);
+  if (state === 'sticky') {
+    pinnedSessionIds.add(id);
+    stickySessionIds.add(id);
+  }
+  savePinnedSessions();
+  renderSessions();
+}
+
 function getSessionPinState(sessionId) {
   if (stickySessionIds.has(sessionId)) return 'sticky';
   if (pinnedSessionIds.has(sessionId)) return 'pinned';
@@ -4153,6 +4166,7 @@ document.addEventListener('keydown', (e) => {
     lastTasksHash = '';
     const refreshes = [fetchSessions()];
     if (currentSessionId) refreshes.push(fetchTasks(currentSessionId));
+    refreshRateLimits();
     Promise.all(refreshes)
       .then(() => showToast('Data refreshed', 'success'))
       .finally(() => {
@@ -4515,6 +4529,10 @@ function setupEventSource() {
         handleSessionOpenEvent(data);
       }
 
+      if (data.type === 'session:pin') {
+        handleSessionPinEvent(data);
+      }
+
       if (data.type === 'team-update') {
         const teamSession = sessions.find((s) => s.isTeam && s.teamName === data.teamName);
         if (teamSession) {
@@ -5725,7 +5743,11 @@ function refreshRateLimits() {
     fetch('/api/context-status')
       .then((r) => r.json())
       .then((all) => {
-        const rl = Object.values(all || {}).find((e) => e?.rate_limits)?.rate_limits || null;
+        let freshest = null;
+        for (const e of Object.values(all || {})) {
+          if (e?.rate_limits && (!freshest || (e._updatedAt || 0) > (freshest._updatedAt || 0))) freshest = e;
+        }
+        const rl = freshest?.rate_limits || null;
         const fh = rl?.five_hour?.used_percentage ?? null;
         const sd = rl?.seven_day?.used_percentage ?? null;
         const key = `${fh}|${sd}`;

package/server.js

@@ -1531,6 +1531,21 @@ app.post('/api/session/open', async (req, res) => {
   }
 });
 
+app.post('/api/session/pin', async (req, res) => {
+  try {
+    const { id, state } = req.body || {};
+    if (!id || typeof id !== 'string') return res.status(400).json({ error: 'id is required' });
+    if (!['none', 'pinned', 'sticky'].includes(state)) {
+      return res.status(400).json({ error: 'state must be none|pinned|sticky' });
+    }
+    broadcast({ type: 'session:pin', id, state });
+    res.json({ success: true, id, state });
+  } catch (error) {
+    console.error('Error in /api/session/pin:', error);
+    res.status(500).json({ error: error.message || 'Failed' });
+  }
+});
+
 app.get('/api/preview', async (req, res) => {
   try {
     const abs = resolvePreviewPath(req.query.path);
@@ -1746,6 +1761,7 @@ contextStatusWatcher.on('all', (event, filePath) => {
   if (event === 'add' || event === 'change') {
     try {
       const data = JSON.parse(readFileSync(filePath, 'utf8'));
+      try { data._updatedAt = statSync(filePath).mtimeMs; } catch (_) { data._updatedAt = Date.now(); }
       contextStatusCache.set(sessionId, data);
       evictStaleCache(contextStatusCache);
     } catch (e) { /* ignore malformed */ }