Kanban Skill
This session id is ${CLAUDE_SESSION_ID}, substituted when the skill loads.
An argument names the section below that handles it; with no argument, open the current session. Prefer the bare claude-code-kanban binary, falling back to npx claude-code-kanban when it is off PATH or the user asks for npx.
To be driven by the board instead — card moves arriving as instructions — the user types /claude-code-kanban:kanban-follow.
open — the current session
Pins the session and switches the board to the Active tab.
claude-code-kanban session open ${CLAUDE_SESSION_ID}
pin — keep the session visible
claude-code-kanban session pin ${CLAUDE_SESSION_ID} # pin
claude-code-kanban session pin ${CLAUDE_SESSION_ID} --sticky # always at the top
claude-code-kanban session pin ${CLAUDE_SESSION_ID} --unpin # clear
claude-code-kanban session pins # list pinned; --sticky narrows
preview — open a file in the modal
Markdown or standalone HTML. HTML renders in a sandboxed iframe, so sibling assets like ./style.css do not load. Relative paths are fine — the server resolves them.
claude-code-kanban preview-doc <file.md|.html> --session ${CLAUDE_SESSION_ID}
link — attach a doc without the modal
Adds the file to the session's linked docs in the sidebar. Any extension, and nothing pops up, so it is the safe choice while the user is working.
claude-code-kanban link-doc <path> --session ${CLAUDE_SESSION_ID} # link
claude-code-kanban link-doc <path> --session ${CLAUDE_SESSION_ID} --unlink # remove
list / view / peek — read-only
claude-code-kanban session list --active # recent active sessions
claude-code-kanban session list --project <name> # filter by project
claude-code-kanban session list --days 0.5 --limit all # touched in last 12h, uncapped
claude-code-kanban session view ${CLAUDE_SESSION_ID} # full stats for current session
claude-code-kanban session peek ${CLAUDE_SESSION_ID} --limit 20 # last 20 messages (server caps at 50)
session list shows 10 rows and always includes pinned sessions, sticky first (--no-pins disables both). --json works on any list-style verb.
Troubleshooting
claude-code-kanban help <command> prints the authoritative flags — read it instead of guessing.
- "Cannot reach cck server…" → the error names the port it tried. Ask the user to start the server with
claude-code-kanban. If they run it elsewhere, setPORT=<n>when invoking the CLI.