CLI reference
Run these commands in a terminal. The examples use crosshead, which is also available as xhd.
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-baseif 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-runto 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
--jsonfor 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, orautofor a profile. Useassistfor ordinary automatic capture oroffto 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 5000prepares 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@crossheadorclaude 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.