Two CLI names
xc and xcoder are aliases. Use whichever you like. All examples below use xc.
Boot & orientation
| Command | Description |
|---|---|
xc boot | Print the live SessionStart context: orientation block + flow-discipline framing. Wired in .claude/settings.json by xc hooks deploy. |
xc boot --json | Same content as structured JSON. |
xc report | Project status: autopilot gate, in-progress items, blockers, open PRs, recent commits, next-step recommendation. |
xc status | Per-agent status (lighter weight than `report`). |
Hooks management
| Command | Description |
|---|---|
xc hooks deploy | Detect runtimes (Claude Code, Cursor, Codex, OpenCode, Zed) and write hook config in place. |
xc hooks list | Show currently-installed hooks across detected runtimes. |
Interactive — xc i
Boots a coding-agent session in the current repo with hooks, skills, and flow guards already wired.
xc i # current repo, no initial prompt
xc i "fix the parser bug" # current repo, with initial prompt
xc i --skill ui # explicit skill (skips auto-detect)Autopilot — continuous loop
Continuous autonomous loop. Picks the next roadmap item, drives the coding agent through the flow, opens PRs.
| Command | Description |
|---|---|
xc autopilot assign <path> | Bind autopilot to a workspace; create the agent record. |
xc autopilot status [id] | Snapshot of phase, in-flight item, recent events. |
xc autopilot stop [id] | Halt the autopilot loop for an agent. |
xc autopilot roadmap [id] | Render the current roadmap (priority, complexity, status per item). |
xc autopilot verdict [path] | Run the merge gate on HEAD against integration; emit a Verdict. |
xc autopilot automerge [path] | Walk all open PRs; auto-merge those whose Verdict permits. |
xc autopilot review-pr <n> | Run the merge gate against a specific PR. |
xc autopilot baseline-refresh | Refresh the calibrate / OWASP / typecheck baselines. |
FlowEngine — xc flow
The user surface for the deterministic engine. See the FlowEngine docs for what it does.
xc flow status
xc flow status
xc flow status --json
xc flow status --cwd /path/to/repoPrints current phase, last acceptance result, last bypass, event count.
xc flow events
xc flow events # last 50, all types
xc flow events -n 200 # last 200
xc flow events --type flow.transition # only transitions
xc flow events --type flow.bypass # audit bypasses
xc flow events --json # JSON Lines on stdoutxc flow override
Record a named bypass for an invariant. --reason is required.
xc flow override I-3 --reason "spike — issue not yet filed"
xc flow override I-7 --reason "ci-generated commit; not author-controlled"
xc flow override I-9 --reason "hotfix shipped via direct merge"xc flow check
Run engine acceptance checks for a hypothetical state — useful when debugging "why won't it advance?":
xc flow check --phase branch --branch feat/widget --issue 42
xc flow check --phase commit
xc flow check --phase pr --pr 1234xc flow demo
Walk a synthetic task through every phase. Useful for verifying the install — produces real events but doesn't touch git or call any LLM.
xc flow demoxc flow invariants
Print the 15-invariant contract directly to your terminal.
PR iteration — xc pr
Agent-facing PR-iteration toolkit. Each subcommand is a single function from agent-tools/; the recommended composition is documented in the pr-iteration skill.
| Command | Description |
|---|---|
xc pr provision <n> | Provision a temp worktree at the PR's HEAD. |
xc pr classify | Decide: clean | normal-merge | abandoned-stack. |
xc pr merge-base | Merge integration into the PR branch (manual conflict resolution). |
xc pr typecheck | Run typecheck; emit structured findings. |
xc pr playbook | Print the full agentic prompt for the iteration loop. |
xc pr teardown <path> | Remove a worktree (and optionally its branch). |
Agents (legacy)
| Command | Description |
|---|---|
xc list | List all attached agents and their status. |
xc add <path> --goal "..." | Attach an agent to a workspace. |
xc remove <id> | Detach an agent. |
xc goal <id> <description...> | Set / update an agent's goal. |
xc start [id] | Launch the supervisor (heartbeat-driven loop). |
xc stop [id] | Stop a running supervisor. |
xc logs [id] | Tail an agent's session log. |
xc run <path> <goal...> | One-shot: add + goal + start. |
xc ps | Show running supervisor processes. |
Configuration & ops
| Command | Description |
|---|---|
xc config show | Print the resolved xCoder config. |
xc config set <key> <value> | Update a config key. |
xc config path | Print the config file path. |
xc doctor | Diagnostic checks: deps, hooks installed, runtimes detected. |
xc test | Run xCoder's internal smoke tests. |
xc skills | List skills + auto-detection results for the current repo. |
xc scan | Cross-repo intelligence index update. |
xc modes | List runtime modes (claude-code / cursor / codex / opencode / zed). |
xc mode <id> <mode> | Set an agent's runtime mode. |