Operon CLI

Team agent registry for AI-native engineering teams.

Operon mines local Claude Code, Codex, and Cursor sessions, turns repeated AI work into governed agents, and syncs them with your team workspace.

Install

Install once:

npm i -g @withoperon/cli
operon setup

Or try without installing:

npx @withoperon/cli@latest setup

Requires Node.js 22 or newer.

setup signs you in, detects Claude Code, Codex, and Cursor, picks or creates a workspace, mines local sessions, and stages candidate drafts for review. It does not publish anything automatically.

Sign In

operon login

The command opens a browser approval page, polls until you approve the device code, and stores an op_pat_* token locally for workspace commands. Pass --workspace <slug> to set a default workspace, or --token <token> to skip the browser flow when you already have a personal access token.

Mine Local Sessions

operon mine --workspace acme --since 30d --top 5 --dry-run

mine reads local Claude Code, Codex, and Cursor transcripts, ranks reusable agent candidates, writes them under ~/.operon/candidates, and stages review drafts in your workspace when you are signed in. Use --dry-run to avoid publishing; omit it to publish selected candidates from the terminal, or pass --yes to publish every surfaced candidate without prompts.

If you want the lower-level pieces:

operon scan --since 30d
operon suggest --top 10

Publish An Operon

operon publish audit-website --workspace acme

publish uploads a polished SKILL.md to the selected workspace. Workspaces with eval gating keep the new version as a draft until it passes.

Install An Operon

operon install acme/audit-website
operon install audit-website --workspace acme

install downloads the current published version, verifies the content hash, caches it under ~/.operon/skills, and writes native Claude Code and Codex skill files. Use --semver to pin a specific version and --target to install only one local runtime.

Other Useful Commands

operon list
operon show audit-website
operon doctor --fix
operon config get platform.apiBase

Run operon <command> --help for command-specific flags.