Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.opper.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Opper CLI is the official opper command for the terminal. Beyond direct platform access — calling functions, managing indexes and models, inspecting traces, tracking usage, generating images — it can also launch coding agents (Claude Code, OpenCode, Codex, Hermes, pi) with their inference transparently routed 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 groupWhat it does
login / logout / whoamiOAuth device flow and account inspection.
callRun an Opper function from the terminal, with --model and --stream.
launch <agent> / agents listLaunch coding agents through Opper — Claude Code, OpenCode, Codex, Hermes, pi.
editorsWire AI code editors (OpenCode) to use Opper as a provider.
skillsInstall, update, list, or uninstall bundled Opper skills.
functions, models, indexes, traces, usageManage every Opper platform resource directly.
image generateGenerate images from a prompt.
configManage 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> is the fastest way to route a coding agent through Opper — every model call from the agent goes through your Opper account, with the trace, cost, and model routing benefits that come with it.
AgentSlugHow Opper plugs in
Claude CodeclaudeANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN env vars
OpenCodeopencodeprovider block in ~/.config/opencode/opencode.json
Codexcodex[model_providers.opper] block in ~/.codex/config.toml
Hermeshermesisolated HERMES_HOME=~/.opper/hermes-home/ so your real ~/.hermes/ is never touched
pipiopper provider entry in ~/.pi/agent/models.json
Anything after the agent name is forwarded to the agent’s CLI verbatim: 
opper launch claude -- --print "Hello"

​
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 myfunction "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.