Skip to main content
The Opper CLI is the official opper command for the terminal. It gives you direct platform access to manage models, inspect traces, track usage, and generate images. It can also launch coding agents (Claude Code, Claude Desktop, OpenCode, Copilot CLI, Codex, Codex Desktop, Hermes, OpenClaw, pi) and route their inference through Opper.

Install

Or run any command on demand without installing:
Requires Node.js ≥ 20.12.

Migrate from the retired Go CLI

The Go CLI and its Homebrew distribution are retired. Use the npm package above for the current CLI. Both versions install an opper executable, so remove the old Homebrew installation before installing the replacement:
If you installed the Go CLI manually or with go install, check which -a opper and remove the old executable from your PATH. Confirm that opper --help shows the current CLI before continuing. Keep ~/.oppercli while migrating. On opper login, the current CLI can import its named API keys and base URLs into ~/.opper/config.json once, provided the new configuration does not already exist and migration has not already been attempted. The legacy file is preserved. If you already configured the current CLI, use opper config add to add any remaining keys instead. Command arguments can differ between versions; check opper <command> --help when updating scripts.

Quick start

What you can do

For full flags on any subcommand: opper <command> --help. Or run opper with no arguments for an interactive menu.

Launch coding agents through Opper

opper launch <agent> routes a coding agent through Opper. Every model call from the agent goes through your Opper account, so you get the same cost tracking and model routing, with each call in Logs and full traces once tracing is on. Anything after the agent name is forwarded to the agent’s CLI verbatim (Claude Desktop and Codex Desktop are GUI-only and do not accept extra arguments):
To remove an agent’s Opper integration without uninstalling the agent itself:
For a full Claude Code walkthrough — model alias mapping, the /model picker, per-project config, and CI — see Run Claude Code on any model.

Ask the CLI a question

opper ask "<question>" runs an Opper agent grounded on the locally-installed Opper skills. The answer streams to your terminal, then prints token and request counts.
Use ask to get unstuck without leaving the terminal. The model has the same skill packs available as the agents you launch through opper launch.

Authentication

Auth state lives in ~/.opper/config.json as a list of slots, each holding an API key and base URL. Use --key <slot> on any command to pick which slot to use. Resolution at request time: OPPER_API_KEY env var > slot named by --key (or default).

Source and reference

View on GitHub The repository README is the source of truth for releases, supported agents, and configuration details. For exact arguments and flags, opper <command> --help is always authoritative.
Last modified on October 6, 2026