Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/project-board-sync.md
Open on GitHub

What 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-sync against the “Development Board” project with two-way sync and status views.
  • Lay out the state mapping in .github/board-sync.yml and 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.md

Call it with /project-board-sync. For all projects use ~/.claude/commands/

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.

Similar slash commands

All slash commands for Git and GitHub →

From the same set76

The whole set →
config Loads a reference for pair programming settings: driver, navigator and switch modes, verification thresholds, test runs and agent profiles kept in .claude-flow/pair-config.json. CX Codex +1 ★ 850repo stars workflow-automation workflow-automation integrates multi-agent swarms with GitHub Actions pipelines to generate CI configurations, select tests, and inspect build failures. CX Codex +1 ★ 850repo stars trading-predictor trading-predictor — a Claude subagent that measures how far its computation runs ahead of market-data delivery, then uses the gap for predictions and risk numbers. CX Codex ★ 850repo stars backend-dev The backend-dev subagent builds backend APIs and draws on earlier API work. Use it for tasks involving endpoints, routes, REST, or GraphQL. CX Codex ★ 850repo stars api-docs api-docs — a Claude Code subagent that inspects application endpoints to produce and maintain OpenAPI 3.0 specifications. CX Codex ★ 850repo stars examples The examples command presents pair-programming sessions for JWT auth, Node.js debugging, TDD, refactoring, React performance, and Express APIs. CX Codex +1 ★ 850repo stars base-template-generator base-template-generator writes the starting file set for a new component, endpoint or project config, then reuses templates that worked before. CX Codex ★ 850repo stars planner planner is a Claude Code subagent that breaks down engineering goals, maps dependencies, and allocates agents using execution memory. CX Codex ★ 850repo stars

Project sponsors

Companies that keep this analytics open