o3c-code-cli

Ori3com AI coding CLI — a terminal coding agent with inter-session memory, a repo-aware code graph, and a free/local model cascade for disconnected use.

npm install -g @o3c/o3c-code-cli
o3c                    # first run: pick a free model, sign in, or paste a key
o3c "fix auth.ts"      # run the coding agent

Install

npm install -g @o3c/o3c-code-cli

Requires Node.js ≥ 20.

Setup

The first time you run o3c without a session, it shows a chooser — you are not forced to sign in:

• Use a free coding model now — no account (the offline picker)
• Sign in with your Ori3com account — the same login as platform/chat.ori3com.cloud
• Paste an API key — an evergreen key for api.ori3com.cloud (offered to be remembered in ~/.o3c/.env)

o3c login     # sign in directly — opens a browser (loopback PKCE)
o3c whoami    # show current user, plan tier + token expiry
o3c logout    # clear the local session

The session is stored under ~/.o3c/.

Offline / free models (no login)

o3c can run against a free or local OpenAI-compatible model when you're offline or just want a zero-cost cascade. Pick one interactively, then use it:

o3c offline                        # choose a free/local model (no key for some providers)
o3c --offline "explain this repo"  # run against the configured model, no login/worker

With a model configured, o3c auto-engages offline when no auth is present, and escalates to the hosted endpoint otherwise.

Usage

o3c "refactor the parser in src/lexer.ts"     # run the agent
o3c -p "list the exported symbols in api.ts"  # non-interactive (print) mode
o3c --offline "rename foo to bar everywhere"  # use the free/local model

Options: -m/--model, -p/--print, --offline, --no-spawn, --permission-mode <mode>, --max-turns <n>.

What's under the hood

• Cognitive memory — the agent remembers across sessions. Prior work is distilled into a local brain (~/.o3c/brain/) and recalled into new sessions. Opt-in cloud sync (O3C_BRAIN_SYNC=1, via rclone) lets the brain oscillate between devices.
• Code-graph context — a dependency/symbol graph of the current repo seeds the session with the most relevant files, and the CodeGraph tool answers structural queries on demand.
• Model cascade — cheapest-capable-first routing, with a free/local rung (o3c offline) that escalates to the hosted endpoint when needed.

Development

npm install
npm run check     # typecheck + build + tests (the full DoD gate)
npm test          # tests only (vitest)
npm run dev -- whoami

License

MIT