Integrations

Bring Zro to your coding tools.

Use the launcher for Zro-owned setup with telemetry disabled, or configure apps manually when they own their provider settings.

Quick startTerminal
npm install -g @moonmath-ai/zro
zro login
zro launch claude --model glm-5.2
zro launch codex --model kimi-k3
zro launch codex-app --model glm-5.2
zro launch grok --model glm-5.2
zro launch pi --model glm-5.2
Map

Choose the right setup path

Zro web search is configured automatically by supported launchers. It costs $0.02 per search from the same spend balance as inference.

ToolMethodCommand or settingWeb searchConfig impact
Claude Codezro launchzro launch claude --model glm-5.2AvailableNo persistent Claude config changes
Codex CLIzro launchzro launch codex --model glm-5.2UnavailableNo ~/.codex/config.toml changes
Grok Buildzro launchzro launch grok --model glm-5.2AvailableTemporary GROK_HOME config only
OpenCodezro launchzro launch opencode --model glm-5.2AvailableTemporary merged config only
Hermeszro launchzro launch hermes --model glm-5.2AvailableTemporary home config only
OpenClawzro launchzro launch openclaw --model glm-5.2AvailableTemporary home config only
Pizro launchzro launch pi --model glm-5.2AvailableTemporary PI_CODING_AGENT_DIR only
Codex Appzro launchzro launch codex-app --model glm-5.2UnavailableZro-owned CODEX_HOME; no ~/.codex changes
ClineManualCline OpenAI Compatible providerNot configuredStored by Cline
CursorManualCursor Settings -> ModelsNot configuredStored by Cursor
CLI

Command reference

zro login

Store your Zro API key once using a masked prompt.

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

Fast setup from the account page. This can land in shell history.

zro auth status

Show whether ZRO_API_KEY or the stored login key will be used.

zro logout

Remove the stored Zro API key.

zro launch claude --model glm-5.2

Launch Claude Code with Zro for this session.

zro launch codex --model kimi-k3 -- --sandbox workspace-write

Launch Codex CLI and pass native Codex flags after --.

zro launch codex-app --model glm-5.2

Launch Codex App with a Zro-owned Codex home.

zro launch grok --model glm-5.2

Launch Grok Build with a temporary Zro config and MCP web search.

zro launch opencode

Launch OpenCode with a temporary Zro provider config.

zro launch pi

Launch Pi with a temporary Zro models.json.

Auth

How Zro login works

Zro stores only your Zro API key. It does not write Claude Code, Codex CLI, or app-owned configs. Codex App uses a Zro-owned CODEX_HOME, and the other launchers build temporary session config at launch time.

1
--api-key

Highest priority. Useful for one-off commands and generated setup snippets.

2
ZRO_API_KEY

Best for CI and shells. If set, it overrides the stored login key.

3
Stored login key

Created by the Zro login command at ~/.config/zro/credentials.json with private file permissions.

Check authTerminal
zro auth status
zro logout
Launchers

Launch with Zro

The Zro launcher disables vendor telemetry and analytics for every launcher-supported tool. Prompts and completions go directly from your machine to the Zro endpoint. When an agent uses web search, Zro sends only its search query—not the full conversation—to Brave Search.

Claude Code

zro launch claude --model glm-5.2

Open /model inside Claude Code if you want to switch Zro models.

Codex CLI

zro launch codex --model glm-5.2

Zro supplies runtime provider overrides and a temporary model catalog.

Codex App

zro launch codex-app --model glm-5.2

Zro launches the desktop app with CODEX_HOME pointed at ~/.config/zro/codex-app.

Grok Build

zro launch grok --model glm-5.2

Zro uses an isolated GROK_HOME with its provider and MCP configuration.

OpenCode

zro launch opencode --model glm-5.2

Zro launches OpenCode with a temporary XDG config root.

Hermes

zro launch hermes --model glm-5.2

Zro uses a temporary Hermes home for the launched session.

OpenClaw

zro launch openclaw --model glm-5.2

Zro writes a temporary OpenClaw home config and removes it after exit.

Pi

zro launch pi --model glm-5.2

Zro points PI_CODING_AGENT_DIR at a temporary agent config with Zro models.

Manual

Apps with their own model settings

These apps connect directly to the Zro endpoint, but unlike the launcher tools they manage their own provider settings. Cursor additionally routes requests through its own servers — see the notes below.

Cline

Use Cline's OpenAI Compatible provider when you want Cline to call Zro directly.

Cline SettingsCline
API Provider: OpenAI Compatible
Base URL: https://zro.moonmath.ai/v1
API Key: sk-...
Model ID: glm-5.2
DeepSeek model ID: deepseek-v4-flash-0731
Kimi model ID: kimi-k3
Max output tokens: 64000

Cursor

Use Cursor's model settings when you want Cursor to manage the provider itself.

Cursor Settings -> ModelsCursor
Open Cursor Settings -> Models.

In the OpenAI API key section:

Enable OpenAI API Key and paste:
sk-...

Enable Override OpenAI Base URL and set:
https://zro.moonmath.ai/v1

Add custom model IDs:
glm-5.2
deepseek-v4-flash-0731
kimi-k3

Click Verify, then Save.