CLI

Install the zro CLI, authenticate once, and launch any supported coding agent against the API.

The zro CLI opens supported coding agents against the API with isolated, session-only configuration. Your agents' normal config files are never edited, and vendor telemetry is disabled for the launched session.

Install

npm install -g @moonmath-ai/zro

Verify the install and see the available commands:

zro --help

Authenticate

zro login opens a browser device flow and stores your API key at ~/.config/zro/credentials.json with private file permissions.

zro login

For CI, scripts, or a one-off command, pass the key directly:

zro login --api-key sk-...

Other auth commands:

zro status    # show whether a key is stored and where it came from
zro logout    # remove the stored key

Auth precedence

When more than one key is available, the CLI uses the first match:

--api-key sk-... on the command line
ZRO_API_KEY in the environment
The key stored by zro login

Launch a harness

zro launch <harness> --model <model>
 
# examples
zro launch claude --model deepseek-v4.1-flash
zro launch codex --model deepseek-v4.1-flash
zro launch opencode --model kimi-k3

Each launched harness runs with temporary, isolated configuration for the session. When the agent exits, the temporary config is removed and your own configuration is untouched.

Harness	Command	Notes
Claude Code	`zro launch claude`	Messages API; switch models with `/model`
Codex CLI	`zro launch codex`	Temporary provider overrides
Codex App	`zro launch codex-app`	Isolated `CODEX_HOME`
OpenCode	`zro launch opencode`	Temporary XDG config root
Grok Build	`zro launch grok`	Isolated `GROK_HOME`
Hermes	`zro launch hermes`	Temporary Hermes home
OpenClaw	`zro launch openclaw`	Temporary OpenClaw home
Pi	`zro launch pi`	Temporary `PI_CODING_AGENT_DIR`

See Integrations for the harness pages, including manual configuration for Cursor and Cline.

Model selection

Any model from Models can be passed to --model, using either the bare ID or its zro/ alias:

zro launch opencode --model deepseek-v4.1-flash
zro launch opencode --model zro/kimi-k3

List the models available to your key:

zro models

Environment variables

Variable	Purpose
`ZRO_API_KEY`	Overrides the stored login key for a single shell or command.

ZRO_API_KEY=sk-... zro launch opencode --model deepseek-v4.1-flash

Updates

zro install

Safety model

The CLI stores only your API key. It does not write to Claude Code, Codex CLI, or other agent-owned config files.
Launchers build temporary, session-scoped configuration and clean it up on exit.
Vendor telemetry and analytics are disabled for launched sessions.
Web search, when a harness uses it, sends only the search query to the search provider, never the full conversation.

Troubleshooting

Run zro status to confirm which key the CLI will use.
Run zro login again if your stored key was revoked or expired.
Run zro --help or zro <command> --help for the full flag list for your installed version.

On this page