Installation

Install the CLI globally, verify the daemon is running, and enable your first repository. Takes about 30 seconds.

Install the CLI

Install @0ctx/cli globally from npm:

npm install -g @0ctx/cli

This gives you the 0ctx command. It works on macOS, Linux, and WSL. Node 18+ is required.

Check the runtime

Verify the daemon is reachable:

0ctx status

This starts the local daemon if it isn't running and reports machine readiness. If something is wrong, run 0ctx doctor --json for diagnostics.

Enable a repository

Navigate into any git repo and enable it:

cd ~/dev/my-project
0ctx enable

This resolves the repo root, creates a workspace, installs capture hooks for GA integrations, bootstraps retrieval, and reports readiness.

What happens after enable

The daemon binds to the repo, installs supported capture integrations, and configures automatic retrieval. From this point, any supported agent (Claude Code, Factory, Antigravity) gets project memory injected automatically when it starts a session in this repo.

Monorepo development

If you're contributing to 0ctx itself and want to run from source:

npm install
npm run build
npm run cli:install-local
cd <repo>
0ctx enable

Troubleshooting

If 0ctx status reports issues, the repair commands can fix most problems automatically:

# Full diagnostics
0ctx doctor --json

# Auto-repair
0ctx repair

# Re-bootstrap retrieval for GA agents
0ctx bootstrap --clients=ga