CLI error reference

Every failure the Operon CLI raises prints a link to this page. The fragment after the # tells you which entry to read.

AUTH_REQUIRED

#auth-required

The CLI has no token in ~/.operon/config.json (or the saved token is invalid).

Fix. Run `operon login` (or `operon setup`) to sign in via the device‑code flow.

NO_SOURCES

#no-sources

Operon mines sessions from Claude Code, Codex, and Cursor. None of those are installed on this machine.

Fix. Install at least one. Claude Code (https://claude.com/code), Codex (https://github.com/openai/codex), or Cursor (https://cursor.com).

NO_CANDIDATES

#no-candidates

Operon scanned your sessions but no recurring prompts crossed the clustering threshold.

Fix. Try a wider window: `operon mine --since 90d` (or `--since 180d`). Operon clusters prompts that repeat across sessions; if you mostly write one‑off prompts there may not be anything to surface yet.

WORKSPACE_NOT_LINKED

#workspace-not-linked

The command needs a workspace and none is set in `~/.operon/config.json`.

Fix. Run `operon setup` to pick or create one, or pass `--workspace <slug>` explicitly.

RATE_LIMITED

#rate-limited

The platform throttled this request. You may have hit the free-plan run cap or an API rate limit.

Fix. Wait a minute and retry. If you keep hitting this, check your run cap at https://app.withoperon.com or upgrade your plan.

NETWORK_ERROR

#network-error

The CLI could not reach app.withoperon.com (or your --api-base override).

Fix. Check connectivity. If you self‑host, pass `--api-base <url>`. Behind a corporate proxy, set HTTP_PROXY/HTTPS_PROXY env vars.

USER_ABORT

#user-abort

You hit Ctrl-C or answered "no" to a confirmation prompt.

Fix. Not an error. Exit code 0. Re-run when ready.

UNKNOWN

#unknown

A failure the CLI could not map to a specific code (the catch-all).

Fix. Re-run the command. If it persists, run `operon doctor` and report the output so we can give it a real code.