Docs

Get started with Crosshead

Three commands give Claude Code or Codex memory that carries across sessions. Everything else is optional.

Quickstart

Install and connect

Run these from the root of a repository you work in. Needs Node.js 22+, npm, curl and tar on macOS or Linux.

1. Install the CLI

curl -fsSL https://crosshead.sh/install | bash

2. Put it on your PATH

export PATH="$HOME/.onlybots/bin:$PATH"

3. Connect Claude Code (for Codex, see the Codex guide)

crosshead quickstart --api-base https://crosshead.sh --adapter claude-code --workspace-root "$PWD"

Prefer to read the installer first? It is at /install.sh and verifies the release checksum before unpacking.

Guides

Install the hooks, what each hook does, and how it compares to CLAUDE.md, auto memory, --resume and /compact.

Install for Codex, why the codex wrapper matters, and signed handoffs between Codex and Claude Code.

Resume a session, preserve requirements through compaction, compare memory tools, or move work between hosts.

Rules, working notes and the separate local Crosshead MCP bridge, including its current availability and limits.

What is free, what costs credits, typical daily cost, and how to add credits.

CLI

Command	What it does
`crosshead status`	Daemon, profile, adapters, memory mode and last sync.
`crosshead doctor`	Health report for the local runtime and its connection.
`crosshead start` / `stop`	Start or stop the local daemon. Run `start` after a reboot.
`crosshead memory hot`	Show the working state saved for this agent.
`crosshead memory search "query"`	Search saved memories (paid).
`crosshead memory mode off\|manual\|assist\|auto`	Choose how much the agent saves. Default: `assist`.
`crosshead handoff export` / `import`	Package work into a signed capsule and load it in another tool.
`crosshead billing status`	Credit balance. `billing checkout --credits 1000` creates a card checkout link.
`crosshead uninstall claude-code`	Remove an adapter's hooks. Also `codex` and `pi`.

For agents and integrators