cboard (Claude Code plugin)
A local, filesystem-backed kanban packaged as a Claude Code plugin. Folders are the
tasks, and you drive it entirely from /cboard:* slash commands. Three pieces ship together:
- A dashboard (
/cboard:serve) — a zero-dependency Python server (scripts/server.py,
stdlib only) that serves a mobile-friendly board you open in any browser, on any device
(laptop, or phone over Tailscale). Drag cards between lanes, attach files, leave review
comments.
- An author (
/cboard:plan) — ask Claude to "add a ticket" or "break this goal into an
epic" and it creates the cards (the board-author skill).
- A worker (
/cboard:work) — monitors the Ready lane, does each task (each in its own
isolated sub-agent), and parks finished work in Test & Review for you to approve (it
never auto-completes to Done — the kanban-worker skill).
If a board ever gets into a weird state, /cboard:fix checks and repairs it.
What's in here
.claude-plugin/plugin.json # plugin manifest
.claude-plugin/marketplace.json # marketplace catalog (this repo is its own marketplace)
commands/init.md # /cboard:init — set up a board, make it the active board
commands/serve.md # /cboard:serve — launch the dashboard (OS-adaptive)
commands/plan.md # /cboard:plan — create a ticket/epic/project
commands/work.md # /cboard:work — monitor Ready and build cards
commands/fix.md # /cboard:fix — check/repair the board
skills/kanban-worker/ # the deterministic worker (SKILL.md)
skills/board-author/ # the card-authoring skill (SKILL.md)
scripts/launch.py # cross-platform launcher: seeds + starts the server
scripts/server.py # the dashboard engine
scripts/board_cli.py # authoring CLI used by the board-author skill
scripts/board_doctor.py # board checker/repairer used by /cboard:fix
scripts/cboard_config.py # remembers the active board (~/.cboard.json)
seed/ # an empty starter board (copied to your board on first run)
tests/ # stdlib unittest suite — engine, CLI, end-to-end (no deps)
uitests/ # optional Playwright browser UI tests (Chromium)
tools/check_js.py # node --check the dashboard's inline browser JS
Requirements
- Claude Code (to install the plugin and run the worker).
- Python 3 on PATH (the dashboard is a stdlib-only Python server — no
pip install).
There is no plugin-manifest field for runtime prerequisites, so this is the place it's stated.
Works on Windows, macOS, and Linux: the commands find whichever of
python3 / python / py -3 exists, and the launcher does the rest in pure Python
(no Unix-only shell commands).
Install from GitHub
This repo is both the plugin and its marketplace. In Claude Code:
/plugin marketplace add iPhoneHungry/claudeBoardPlugin
/plugin install cboard@cboard
/reload-plugins # required — activates the /cboard:* commands
(marketplace add also takes a full git URL, and @branch to pin a branch/tag.)
To work on the plugin itself instead, load it from disk:
claude --plugin-dir /path/to/claudeBoardPlugin
Quickstart (first run)
After the install block above (incl. /reload-plugins):
1. /cboard:init pick where the board lives — it's remembered as the
active board, so later commands need no path
2. /cboard:plan add a snake game creates a card in PLANNING, then offers to move it to
Ready so the worker can pick it up — say yes
3. turn on auto-accept (Shift+Tab), the worker runs unattended; without this it stalls
then /cboard:work waiting for approval on every step
4. /cboard:serve open the dashboard to preview the result, then
approve it to Done (or send it back with a comment)
💡 You don't have to use the slash commands — you can just talk to Claude: "add a ticket
to fix the header", "move it to Ready", "run the worker", "what's on the board?".
Why didn't the worker do anything? New cards land in Planning, and the worker only
runs the Ready lane (that gate keeps you in control of what runs unattended). Move a card
to Ready first — /cboard:plan offers to, or drag it in /cboard:serve, or just say "move it
to Ready". Your board data lives in your folder, separate from the plugin, so updates never
touch your tasks.
Commands
