project-board-sync — Claude Code command
project-board-sync — a command that keeps a GitHub Projects board in step with agent-swarm tasks: states, agent labels and priorities land in the right columns.
no license ★ 850 updated 2026-10-26
.claude/commands/project-board-sync.mdWhat project-board-sync does
This command lays out how to wire an agent swarm to a GitHub Projects board. gh fetches the project id, then npx ruv-swarm github board-init turns on two-way sync and builds views for status, agent workload and priority. From there board-sync moves cards following a mapping table.
That table is .github/board-sync.yml. Six task states (pending, assigned, in_progress, review, completed, blocked) get columns from Backlog through Done, agent roles become labels, priority becomes a project field. Custom fields such as agent count or ETA read their values off the task itself.
Automation is the other half: assignment balanced by workload, a card sliding into Review once tests pass, plus analytics and reports. It all runs on gh and ruv-swarm, and the examples parse JSON with jq, so a box missing those tools will stall on the first command.
What it helps with
- map swarm task states onto GitHub Projects columns
- move cards between columns without dragging them by hand
- turn priorities and agent roles into project fields
- pull sprint metrics off the board into a report
- keep two boards or two organisations in step
Example prompts for the agent
- Run
/project-board-syncagainst the “Development Board” project with two-way sync and status views. - Lay out the state mapping in
.github/board-sync.ymland shift the cards to match it. - Build a sprint report from the board and export the metrics as markdown.
How to install project-board-sync
Manually: put the files in place
.claude/commands/project-board-sync.mdCall it with /project-board-sync. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/project-board-sync.mdCall it with /prompts:project-board-sync. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/project-board-sync.prompt.mdManually: put the files in place
.gemini/commands/project-board-sync.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about project-board-sync
How do I install project-board-sync in Claude Code?
Place the command file at .claude/commands/project-board-sync.md. It then runs as /project-board-sync.
What does project-board-sync do?
It links agent-swarm tasks to a GitHub Projects board: two-way sync, card placement driven by .github/board-sync.yml, and automation with reports on top.
What does it need before it can run?
gh CLI signed in with access to the project, and npx ruv-swarm. Some examples also pipe JSON through jq.