The Contox CLI (contox) is the universal command-line interface for managing your AI project memory. It works with any AI coding tool and provides full control over your project's knowledge base.
| Field | Value |
|---|
| npm package | contox-cli |
| Binary name | contox |
| Install | npm install -g contox-cli |
| Command | Description |
|---|
login | Store your API key in the global config file |
whoami | Show current authentication status and config details |
init | Initialize a project by creating .contox.json and updating CLAUDE.md |
| Command | Description |
|---|
memory | Load the full project memory via the V2 brain |
save | Save session work into categorized sub-contexts |
context | Build a focused context pack via V2 semantic search |
| Command | Description |
|---|
scan | Scan your codebase and generate hierarchical sub-contexts |
push | Push local files as contexts to the Contox platform |
pull | Pull contexts from the platform to local markdown files |
status | Show a table of contexts with their sync status |
export | Export your brain to Cursor Rules, Copilot instructions, or markdown |
| Command | Description |
|---|
oncall | View operational summary: recent sessions, stale drafts, bugs, brain health |
explain | Deep-dive into any brain schema key with metadata, links, and entries |
approve | Flush the daemon and show brain stats |
hygiene | Analyze and clean up memory items with a two-phase review workflow |
| Command | Description |
|---|
daemon | Manage the background daemon for auto-capture |
collect | Collect session evidence and send to the V2 ingest pipeline |
All commands that interact with the Contox API require authentication. Run contox login first to store your API key, then contox init inside your project directory to link it to a Contox project.
Configuration is resolved in the following order of precedence:
- Command-line flags (highest priority)
- Environment variables (
CONTOX_API_KEY, CONTOX_API_URL, CONTOX_TEAM_ID, CONTOX_PROJECT_ID)
- Project config (
.contox.json in current directory)
- Global config (
~/.contoxrc)
See Configuration for full details.
