| 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", "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). |
Kanban Skill
Drive the kanban from this Claude session. Every command corresponds to something the user could do in the kanban dashboard.
The current Claude session id is available as ${CLAUDE_SESSION_ID} (substituted when this skill loads), so the user never needs to look it up.
NOTE, sometimes user prefers npx claude-code-kanban to claude-code-kanban — both work, as long as the CLI is available. Use npx as fallback or when user instructed explicitly.
Open the current session in kanban
Primary use case. Pins the active Claude session in the kanban sidebar and switches to the Active tab.
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.
claude-code-kanban session pin ${CLAUDE_SESSION_ID}
claude-code-kanban session pin ${CLAUDE_SESSION_ID} --sticky
claude-code-kanban session pin ${CLAUDE_SESSION_ID} --unpin
Trigger phrases: "pin this session", "pin in kanban", "make this session sticky", "unpin session".
List pinned sessions
claude-code-kanban session pins
claude-code-kanban session pins --sticky
claude-code-kanban session pins --json
Trigger phrases: "show pinned sessions", "what's pinned", "list pins".
Preview a file in kanban
Opens a markdown file in the preview modal:
claude-code-kanban preview <path-to-file.md> --session ${CLAUDE_SESSION_ID}
Relative paths are fine — the server resolves to absolute.
Inspect sessions (read-only)
When the user asks "what's going on in kanban?" or wants stats:
claude-code-kanban session list --active
claude-code-kanban session list --project <name>
claude-code-kanban session view ${CLAUDE_SESSION_ID}
claude-code-kanban session peek ${CLAUDE_SESSION_ID} --limit 20
Add --json to any list-style verb for machine-readable output.
Troubleshooting
- "Cannot reach cck server on port 3456" → ask the user to start it:
claude-code-kanban (or npm start in the cck repo).
- Different port → set
PORT=<n> env var when invoking the CLI.
- Ambiguous session prefix (HTTP 409) → use the full id. With
${CLAUDE_SESSION_ID} this won't happen.