CLI

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

Install

npm i -g @opperai/cli

Or run any command on demand without installing:

npx @opperai/cli <command>

Requires Node.js ≥ 20.12.

Quick start

opper login              # OAuth device flow
opper whoami             # confirm the active account
opper launch claude      # launch Claude Code through Opper

What you can do

Command group	What it does
`login` / `logout` / `whoami`	OAuth device flow and account inspection.
`ask`	Ask a question grounded on the installed Opper skills. Useful for “how do I…” questions about the platform, SDKs, or the CLI itself.
`call`	Run an Opper call from the terminal, with `--model` and `--stream`.
`launch <agent>` / `agents list` / `agents uninstall <agent>`	Launch coding agents through Opper (Claude Code, Claude Desktop, OpenCode, Codex, Hermes, OpenClaw, pi). `agents uninstall` removes the Opper integration without uninstalling the agent itself.
`editors`	Wire AI code editors (OpenCode) to use Opper as a provider.
`skills`	Install, update, list, or uninstall bundled Opper skills.
`models`, `traces`, `usage`	Manage every Opper platform resource directly.
`image generate`	Generate images from a prompt.
`config`	Manage stored API keys and slots.

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 traces, cost tracking, and model routing.

Agent	Slug	How Opper plugs in
Claude Code	`claude`	`ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` env vars
Claude Desktop	`claude-desktop`	writes a third-party-inference (`deploymentMode: "3p"`) profile into `~/Library/Application Support/Claude-3p/` (macOS) / `%LOCALAPPDATA%\Claude-3p\` (Windows); quits and reopens the GUI app to apply
OpenCode	`opencode`	provider block in `~/.config/opencode/opencode.json`
Codex	`codex`	`[model_providers.opper]` block in `~/.codex/config.toml`
Hermes	`hermes`	isolated `HERMES_HOME=~/.opper/hermes-home/` so your real `~/.hermes/` is never touched
OpenClaw	`openclaw`	`opper` provider entry in `~/.openclaw/agents/main/agent/models.json`; defaults to running `gateway start` (background daemon)
pi	`pi`	`opper` provider entry in `~/.pi/agent/models.json`

Anything after the agent name is forwarded to the agent’s CLI verbatim (Claude Desktop is GUI-only and does not accept extra arguments):

opper launch claude -- --print "Hello"

To remove an agent’s Opper integration without uninstalling the agent itself:

opper agents uninstall claude-desktop   # works for any registered adapter

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.

opper skills install                                          # one-time
opper ask "how do I make a call?"
opper ask --model anthropic/claude-opus-4-7 "compare the v2 and v3 APIs"

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).

opper config add staging <api-key> --base-url https://...
opper call --key staging my-call "instructions" "input"

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.

Get started

Platform

Build

Control Plane

Tutorials

Tooling

Install

Quick start

What you can do

Launch coding agents through Opper

Ask the CLI a question

Authentication

Source and reference

​Install

​Quick start

​What you can do

​Launch coding agents through Opper

​Ask the CLI a question

​Authentication

​Source and reference

Install

Quick start

What you can do

Launch coding agents through Opper

Ask the CLI a question

Authentication

Source and reference