CLI reference

Run these commands in a terminal. The examples use crosshead, which is also available as xhd.

On this page

Setup and health

crosshead quickstart
Open guided setup. For an explicit setup preview use --scope project --workspace-root . --adapter both --profile <name> --dry-run. Add --api-base if setup needs to create that profile.
crosshead status / crosshead doctor
Show runtime and profile state, or get a health report for the local runtime and its service connection.
crosshead start / crosshead stop
Start or stop the local daemon. To stop capture across sessions, use a memory mode or remove the hooks.
crosshead logs
Inspect local runtime logs for sync, authentication, or lifecycle problems.

Workspaces and identity

crosshead workspace list / crosshead workspace check
Show configured hooks and overrides. Check resolves the exact directory and reports observed startup and resume.
crosshead workspace add / crosshead workspace remove
Change which projects and hosts use automatic hooks in project scope. Use --dry-run to see the plan.
crosshead workspace profile set / clear
Assign or clear a directory override in 0.5.1+. See the folder example.

Memory and billing

crosshead memory hot --scope all
Inspect recent working state for the selected profile. Add --json for structured output.
crosshead memory sync
Inspect background hot sync and pending writes.
crosshead memory warm
List existing warm memories.
crosshead memory search "query" --top-k 5
Look for matching memory. Hosted search uses credits.
crosshead memory mode <mode>
Choose off, manual, assist, or auto for a profile. Use assist for ordinary automatic capture or off to stop automatic memory. Choose manual workspace scope if you want to remove automatic workspace wiring.
crosshead billing status
See credit balance and funding options. crosshead billing checkout --credits 5000 prepares a card payment link for $5 on the public service.

Updates and removal

crosshead update --policy
See the current runtime update policy. For manual updates see the upgrade instructions.
crosshead uninstall codex / crosshead uninstall claude-code
Remove adapter-written hooks and wiring. If you installed a marketplace plugin, also remove it with codex plugin remove crosshead@crosshead or claude plugin uninstall crosshead@crosshead.
crosshead uninstall
Remove the runtime after disconnecting your tools. For hosted records, use memory deletion.

Run crosshead help to see the commands and flags supported by your installed version.