doctor
The doctor command runs diagnostic checks on the cc-fleet installation and reports which checks pass, warn, or fail. Use this when experiencing issues with cc-fleet functionality or before troubleshooting other problems. It provides actionable next steps for any warnings or failures, such as missing dependencies or incomplete skill installations, without modifying any configuration.
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/ethanhq/cc-fleet/HEAD/commands/doctor.md -o ~/.claude/commands/doctor.mddoctor.md
!`cc-fleet doctor 2>&1 || echo "(cc-fleet not available — install it and ensure it is on PATH)"` Read the diagnostics above and give the user a short, actionable summary: - which checks pass, warn, or fail, - for each WARN/FAIL, the concrete next step (the check's own fix hint is usually the answer). Note: the "skills installed" check is OK when the per-lane skills (subagent / team / workflow) are present via plugin OR `make install-skill`; it WARNs only on a partial install or if the legacy single skill coexists with the new ones. This is a **read-only** diagnostic; do not change any config.
Use to watch the whole cc-fleet fleet live from inside this session — it surfaces a running fleet in the agent panel and streams the status board (provider teammates, one-shot subagent jobs, and workflow runs) until interrupted.
Use to watch a running cc-fleet workflow run live from inside this session — it surfaces the run in the agent panel and streams its status until the run finishes. Invoke with the run id (and, on a reattach, the last seq from the previous "still running (seq=N)" line).
List cc-fleet provider teammates, async jobs, and pane health (read-only)
Run a one-shot or flat parallel batch of provider LLM subagents (headless `cc-fleet subagent`) that return a result. Use when fanning out N independent tasks, doing bulk per-file work, or calling a specialized provider model (DeepSeek / GLM / Kimi / Qwen / MiniMax). NOT a long-lived collaborator you message back and forth (that is /cc-fleet:team); NOT a multi-phase pipeline with dependencies or resume (that is /cc-fleet:workflow); NOT trivial work the main session should just do.
Spawn long-lived provider LLM teammates in tmux panes that you message via the native agent-team tools — multi-turn, collaborative, watchable. Use for sustained parallel build/work ("spawn workers", N teammates on N files), or when you need a collaborator you message across turns. NOT a fire-and-forget one-shot or a flat batch of independent prompts — that is /cc-fleet:subagent. NOT a scripted multi-phase run — that is /cc-fleet:workflow.
Orchestrate a MULTI-PHASE, dependent, or resumable run over many provider subagents from a JS script, off the main context (`cc-fleet workflow`). Use for fan-out→barrier→synthesis, per-item pipelines, loop-until-dry, or a run that must survive a kill and `--resume` from its journal. NOT a flat fan-out of independent tasks (that is /cc-fleet:subagent — cheaper, no script); NOT interactive collaboration (that is /cc-fleet:team); NOT trivial single-shot work for the main session.