BharatRouter Code (brcode)

brcode is a Codex-/Claude-Code-style coding agent CLI, routed through BharatRouter. One br- key drives six harnesses; your org's profile (default model, MCP connectors, rules) follows every teammate with a single command; and everything a coding agent does is metered, budgeted, and audited on the gateway.

This is the full guide. For the short pitch see the product page; for the HTTP endpoints behind the CLI see the API reference. Migrating? From Codex · from Claude Code — and read Context & memory for what carries over.

Install

Homebrew (macOS / Linux):

brew install bharatrouter/tap/brcode

Or one line (no Homebrew):

curl -fsSL https://bharatrouter.com/install/brcode.sh | bash

Both give you brcode (and the br alias). The engine (OpenCode, MIT) is installed on first brcode init; Node is the only prerequisite (Homebrew installs it for you). Update with brew upgrade brcode. Windows: use WSL.

Quickstart

brcode login   # browser opens, key lands in the CLI — zero paste
brcode init    # engine + your org's profile (model, MCP connectors, rules)
brcode         # start coding

That's the whole onboarding — init pulls the org profile from GET /v1/me/profile, so a new teammate inherits the lead's exact setup. A lead pushes their local setup up with brcode export.

Command reference

Per-launch overrides: BHARATROUTER_MODEL=glm-4.7 brcode wins for one session; BRCODE_FULL=1 restores the engine's full TUI.

In-agent commands & shortcuts

Slash commands (typed inside the running TUI): /login, /doctor, /brprofile. The engine's leader key is ctrl+x:

Full list: OpenCode keybinds. Other harnesses (brcode claude etc.) keep their own native keymaps.

Harnesses — one key, your choice of agent

Harness choice is launch-time; the model is switchable everywhere (persisted via brcode model, mid-chat via the TUI model list). All harnesses share the same repo context (AGENTS.md) and the same gateway-side governance.

Agent identity & ₹ budgets

brcode identity on          # this machine codes as its own agent (agt_…)
brcode identity budget 500  # cap it at ₹500/month
brcode identity status      # spend + cap per agent
brcode identity revoke      # kill-switch: every live token dies

With identity on, each coding session swaps the shared org key for a short-lived per-agent token (minutes-long ES256 JWT — nothing durable to leak). You get per-agent ₹ attribution in brcode usage and on the dashboard, one-command revocation, and per-agent monthly budgets: once a capped agent exhausts its ₹, its calls are denied with 429 agent_budget_exceeded until you raise or clear the cap. No identity infrastructure to stand up — BharatRouter provisions everything behind the scenes.

Sandbox

brcode sandbox on      # project-scoped policy
brcode sandbox strict  # + macOS OS-level write-jail
brcode sandbox status

• on — permission rules pinned into the engine config: paths outside the project ask first; sudo and rm -rf on / or ~ are denied; git push asks. Everything else flows.
• strict — every edit/command/fetch asks, and on macOS the engine runs inside a Seatbelt profile that physically cannot write outside the project directory, temp, and its own caches — even a call that slips past policy can't touch your dotfiles or ~/.ssh. Linux stays policy-only for now.

Scope: the OpenCode engine (brcode, brcode acp). Other harnesses keep their own native permission systems (Claude Code's permission modes, etc.). Reads are not jailed in v1 — policy still asks on external paths.

Context & memory — what carries, what doesn't

The question everyone asks when switching tools. The honest breakdown:

So: durable context (repo memory, rules, skills, connectors) carries; ephemeral conversation state doesn't — and never did, in any of these tools.

Config files

Troubleshooting

• Start with brcode doctor — it checks the engine, key, and live routing in one shot.
• HTTP 000 / timeouts on a corporate network — a TLS-inspecting proxy (Zscaler and friends) may block api.bharatrouter.com; doctor flags this. Ask IT to exempt the domain.
• Rotated your key? brcode login again. A running session keeps its startup credentials — restart brcode to pick up the new key.
• "agent_budget_exceeded" — this machine's identity hit its monthly cap: brcode identity budget 1000 to raise, or off to clear.
• Agent stuck at BUILD / "Bad Gateway" on a Sangam model — a consensus ensemble (bharatrouter/auto, sangam, open-sangam, glm-sangam) can't arbitrate tool calls, which coding agents need on every step. The gateway now serves a tool-bearing request on a single tool-capable GLM instead (the x-br-auto-delegate response header names it), so agents just work. If you still see this, the gateway predates the fix — brcode model default switches you to the org-default model.
• Engine updates — brcode init is idempotent; rerun it any time to repair configs.

Not affiliated with OpenAI ("Codex") or Anthropic ("Claude Code" / "Claude"). Built on OpenCode (MIT); Aider, Goose, Crush and Qwen Code are independent open-source projects — brcode launches your installed copy, routed through BharatRouter.