UnisonCLI
The unison CLI - auth, search, context recall, document and knowledge-graph commands, and admin operations, grouped for humans and shell agents.
The unison CLI is the complete brain surface, grouped for humans and shell-capable agents.
Install
npm i -g @unisonlabs/cli # or: pnpm add -g / bun add -g / npx @unisonlabs/cli
unison auth login # email OTP, no browserRuns on Node or Bun — the published binary is plain compiled JS, nothing to build. Auth is terminal-only (email OTP). For CI/headless, set UNISON_TOKEN=usk_live_... instead of logging in.
Everyday commands
unison context "what did we decide about auth" --json
unison search "queue migration" -k 5
unison get /workspace/decisions/queue.md
unison write /private/notes/today.md -m "switched to pgmq" --tag infra
unison ingest --conversation session.json --source-ref session-42
unison remember --session ~/.claude/projects/.../session.jsonl # curate a whole session
unison statusCommand groups
| Group | Commands |
|---|---|
| recall | context, search, grep, get (alias cat), ls, tree, find, neighbors |
| write | write, rm, tag, share, ingest, remember |
| graph | entity ls/resolve/get/set, fact ls/add/correct/rm, timeline, links, link |
| admin | review ls/merge/distinct/merges/undo, jobs ls/stats/retry |
| auth | auth login/logout/status, auth keys create, invitations, workspaces |
Useful flags everywhere: --json for machine consumption, --as-of for time-travel reads, --path-prefix to scope recall, --actor <id> (or UNISON_ACTOR) for delegation, --if-match for safe writes.
Point at a different backend with UNISON_API_URL or unison auth login --api-url <url>.