cm-dashboard — Multi-Agent Mission Control

Visual + API control plane for tasks dispatched to Codex, Google Antigravity, Cursor, Gemini CLI, and Claude Code. Runs locally at http://localhost:6969.

When to use

• You are juggling work across multiple AI coding agents and need one source of truth.
• You want a kanban (backlog → in-progress → review → done) per project.
• You need to dispatch a task to a specific agent and capture its progress.
• A CLI agent (Codex, Gemini, etc.) needs to report its conversation lifecycle to a shared board.

Supported agents

ID	Display name	Skill prefix
codex	OpenAI Codex	/
antigravity	Google Antigravity	@[/...]
cursor	Cursor	@
gemini-cli	Gemini CLI	@[/...]
claude-code	Claude Code	/

(Also: windsurf, cline, copilot, manual.)

Quick start

# 1. Start the dashboard (auto-starts on first cm command, or run explicitly)
cm dashboard         # opens http://localhost:6969

# 2. Health-check
curl -s http://localhost:6969/api/projects | jq

Core workflows

A. Create + dispatch a task to an agent

# Create
TASK_ID=$(curl -s -X POST http://localhost:6969/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"title":"Refactor auth middleware","agent":"codex","skill":"cm-execution","priority":"high"}' \
  | jq -r .id)

# Dispatch (writes .agent-tasks/<id>-*.agent-task.md inside the project)
curl -s -X POST http://localhost:6969/api/tasks/$TASK_ID/dispatch | jq

The dispatcher emits a per-agent CLI command:

• codex --task "<file>"
• antigravity -p "$(cat <file>)"
• cursor --task "<file>"
• gemini run --task "<file>"
• claude --task "<file>"

B. Move a task across columns

curl -s -X PUT http://localhost:6969/api/tasks/$TASK_ID/move \
  -H "Content-Type: application/json" \
  -d '{"column":"in-progress"}'   # backlog | in-progress | review | done

C. Auto-sync from an agent conversation

Use this from a running Codex/Gemini/Cursor/Antigravity session to report status — upserts by conversationId.

curl -s -X POST http://localhost:6969/api/tasks/auto-sync \
  -H "Content-Type: application/json" \
  -d '{
    "conversationId":"codex-2026-05-11-001",
    "title":"Refactor auth middleware",
    "status":"in-progress",
    "agent":"codex",
    "skill":"cm-execution"
  }'

Status values map to columns: pending|todo → backlog, started|active|in-progress|idle → in-progress, review → review, completed|done → done.

D. Get agent suggestions for a skill

curl -s 'http://localhost:6969/api/agents/suggest?skill=cm-debugging' | jq
# → { skill, domain, agents: ["claude-code","codex","cursor","antigravity"] }

E. Live activity & per-agent badges

The web UI shows:

• Agent badges with color + task count per agent (Codex teal, Antigravity green, Cursor blue, Gemini gold, Claude purple).
• Active Agents sidebar — currently working on in-progress tasks.
• Activity feed — task created/moved/dispatched/transitioned events in real time (WebSocket).

API reference (most-used)

Method	Path	Purpose
GET	/api/projects	List projects with task counts
POST	/api/projects	Create project
GET	/api/tasks?projectId=…	List tasks (optionally per project)
POST	/api/tasks	Create task (agent, skill, …)
POST	/api/tasks/sync	Bulk import tasks from an agent
POST	/api/tasks/auto-sync	Upsert by conversationId
PUT	/api/tasks/:id/move	Move to column
POST	/api/tasks/:id/dispatch	Write .agent-tasks/*.md for agent
GET	/api/agents/suggest?skill=…	Best agents for a skill domain
GET	/api/judge/suggestions?projectId=…	Auto-transition recommendations

Full surface: see src/dashboard.ts.

Recommended per-agent usage

Domain	Best fit
Engineering / refactor / debugging	Claude Code, Codex
Long-context architecture & docs	Antigravity, Gemini
Inline edits / IDE-driven	Cursor
Quick CLI prompts / shell tasks	Gemini CLI, Codex

Troubleshooting

• {"error":"not found"} — endpoint typo; check the table above. The fallback returns 404 for any unknown /api/*.
• Port 6969 already in use — another dashboard is running. lsof -i :6969 to find it.
• NO_AGENT on dispatch — task has no agent set; PUT /api/tasks/:id with {"agent":"codex"} first.
• NO_PROJECT_PATH — set the project's path so dispatch can write into .agent-tasks/.

Files of authority

• src/dashboard.ts — HTTP API
• src/agent-dispatch.ts — per-agent file + CLI generation
• src/judge.ts — agent affinity per skill domain
• public/dashboard/app.js — UI badges and colors