CLI Reference

Back to home

V1 Honesty: OffRouter routes delegated work. It does not replace your harness's primary model call.

Commands

offrouter init

Detect installed harnesses and check readiness.

offrouter init
offrouter init --dry-run --json

offrouter doctor

Report Node version, config validity, harness detection, provider readiness, and MCP serve path. Secret values are never printed.

offrouter doctor
offrouter doctor --json
offrouter doctor --profile claude-personal

offrouter login

List available provider categories and detect auth readiness. In the current alpha, this is a guide surface.

offrouter login

offrouter install

Install OffRouter into a harness profile.

offrouter install claude --profile claude-personal --dry-run
offrouter install claude --profile claude-personal

offrouter uninstall

Remove OffRouter from a harness profile and restore previous files.

offrouter uninstall claude --profile claude-personal --dry-run
offrouter uninstall claude --profile claude-personal

offrouter route explain

Explain the routing decision for a prompt. Local policy checks only. No provider is called.

offrouter route explain "explain this repo" --profile claude-personal

offrouter mcp serve

Start the MCP server for delegation tools over stdio.

offrouter mcp serve

offrouter proxy serve

Start a local OpenAI Responses-compatible proxy for apps that support custom base URLs.

offrouter proxy serve

Listens on http://127.0.0.1:8787 by default.

offrouter models

List configured provider ids. Live model discovery arrives with provider adapters.

offrouter models

offrouter profiles

List configured profiles and their status.

offrouter profiles

offrouter status

Show provider and profile status.

offrouter status --providers --json

Environment Variables

The CLI detects these by name only (never prints values):

ANTHROPIC_API_KEY
OPENAI_API_KEY
OPENROUTER_API_KEY
XAI_API_KEY
GOOGLE_API_KEY
GEMINI_API_KEY
OFFROUTER_API_KEY
OLLAMA_HOST