Documentation

Migrate from Codex CLI

brcode is deliberately Codex-shaped: a short command, a TUI agent, repo context in AGENTS.md, login → init → code. If you're comfortable in Codex, you already know how to use it.

brew install bharatrouter/tap/brcode
brcode login && brcode init
brcode       # same repo, same AGENTS.md, coding in under a minute

What maps to what

Codex concept	With brcode
`AGENTS.md` (repo context)	Read unchanged, zero work — the engine reads the same file, and `brcode memory` keeps a `CLAUDE.md` mirror so Claude-style harnesses share it too.
`codex` TUI	`brcode` — a Codex-style TUI (OpenCode engine) with sessions, model list, subagents, skills. `brcode "fix the tests"` for one-shot prompts.
`~/.codex/config.toml`	You mostly don't need one: model + MCP connectors + rules come from your org profile on `brcode init`. Local overrides: `brcode model`, `brcode route`.
ChatGPT/OpenAI login + USD billing	One org `br-` key, INR billing with GST invoices, per-key/team/agent ₹ budgets.
Sandbox (Seatbelt/landlock)	`brcode sandbox` — permission policy everywhere, plus a macOS Seatbelt write-jail in `strict`.
Model (GPT family)	Your pick of the catalog — GLM by default; switch any time with `brcode model`, mid-chat via the TUI, or use Sangam consensus routing.

Do I lose memory or context?

Repo context: no. AGENTS.md is the contract both tools honour — it travels with git and brcode reads it exactly like Codex does. Custom instructions that live in your Codex config are worth moving into AGENTS.md (repo-level) or the org profile's rules (team-level) — after that they follow every machine and every harness. Chat history: no tool carries this across — Codex sessions stay in Codex, same as switching Codex → Claude Code today. Summarise any long-running thread into AGENTS.md before you switch. Full breakdown: Context & memory.

Prefer to keep the Codex CLI itself?

BharatRouter speaks the Responses API, so the actual codex binary can route through the gateway with a custom provider (wire_api = "responses", base URL https://api.bharatrouter.com/v1, your br- key). You keep the client and still gain metering, budgets and routing — the same "keep your CLI" path Claude Code users get with brcode claude.

What you gain

Team handover — a new teammate inherits model + connectors + rules in two commands.
Six harnesses on one key — Codex-style, Claude Code, Aider, Goose, Crush, Qwen Code; pick per task.
Governance — ₹ metering/budgets/audit on the gateway, per-machine agent identity with caps and revocation.
India routing & INR — residency controls, rupee billing, GST invoices.

"Codex" is OpenAI's product; brcode is not affiliated with OpenAI. See the full brcode guide.