Reference overview

Last updated: 2026-09-06

This section documents every orca command, flag, and default, verified against the source of cli-v0.5.0. For the narrative guides (install, sign in, scripting), start at the CLI overview.

Global flags

These flags are accepted by every command, before or after the subcommand.

Flag	Description
`--json`	Machine-readable JSON output on stdout, nothing else. Streaming commands emit NDJSON
`--context <name>`	Use a named context from the config file instead of the current one. `ORCA_CONTEXT` does the same from the environment
`--api-url <url>`	Override the conductor API base URL for this invocation. `ORCA_API_URL` does the same from the environment
`-v, --version`	Print the CLI version. In a terminal, a newer-release hint may follow on stderr
`-h, --help`	Help for the command

There is no --api-key flag; the key comes from the config file or ORCA_API_KEY. There is no --tenant flag either, since the tenant is derived from the key. orca chat is the one exception: it talks to the public gateway with a chat key and takes --tenant and --key.

Conventions

<arg> is a required positional. [arg] is optional: in an interactive terminal the CLI opens a picker when it is omitted; in a pipe or script it is required and omitting it exits 2.
[prompt...] collects every remaining argument into one prompt, so quoting is optional unless the prompt contains shell metacharacters.
Destructive subcommands (delete, remove, rm, unpublish, keys revoke, workflows cancel, billing cap set) ask for confirmation in a terminal and require --yes in a script. runs cancel and agents keys revoke act immediately with no prompt, and auth logout --revoke proceeds without --yes in a script rather than refusing.
Repeatable flags (--member, --header, --read, and so on) may be passed any number of times.
Options that take values accept both --flag value and --flag=value.

Shared paging flags

List commands marked “paged” below accept:

Flag	Type	Default	Description
`--limit <n>`	integer	`10`	Page size (positive)
`--offset <n>`	integer	`0`	Page offset (non-negative)
`--all`	boolean	`false`	Fetch every page, in windows of 200, up to 10,000 rows. Cannot be combined with `--limit` or `--offset`

See Pagination for the exceptions.

Exit codes

0 ok, 1 failure, 2 usage, 3 auth, 4 not found, 130 interrupted. Details in Output and scripting.

Command index

Core

Command	Description	Page
`orca run [agent] [prompt...]`	Start a run and stream it	run and chat
`orca chat [agent] [prompt...]`	Chat with a published agent through the public gateway	run and chat
`orca agents list` (paged), `get`, `changes`, `create`, `update`, `delete`, `publish`, `unpublish`, `keys list` (paged), `keys create`, `keys revoke`	Manage agent profiles and chat keys	agents
`orca runs list` (paged), `get`, `cancel`, `tail`	Inspect and control runs	runs

Observe

Command	Description	Page
`orca stats`, `stats agents`, `stats hotspots`	Run and latency metrics over a window	stats and usage
`orca usage`	Token, cost, or run usage over a window	stats and usage
`orca sessions list` (paged), `get`	Session history	sessions
`orca doctor`	Connectivity and configuration checks	platform
`orca topology`	Live view of the runner pool	platform
`orca bundles`	Capability bundles agents can attach	platform
`orca apps`	Connected Apps providers and connections	platform

Manage

Command	Description	Page
`orca workflows list` (paged), `get`, `delete`, `runs` (paged), `runs get`, `start`, `tail`, `cancel`, `repair`, `schedules` (paged), `schedules get`, `schedules pause`, `schedules resume`, `schedules delete`	View and control workflows	workflows
`orca pools list` (paged), `get`, `create`, `delete`, `members add`, `members remove`	Agent pools and membership	pools
`orca skills list` (paged), `get`, `delete`, `import`, `attach`, `detach`	Skill catalog	skills
`orca mcp serve`, `list` (paged), `get`, `add`, `set`, `remove`, `test`, `attach`, `detach`	MCP server catalog and the built-in MCP server	mcp
`orca secrets list` (paged), `set`, `delete`	Tenant secrets	secrets
`orca storage info`, `ls`, `browse`, `get`, `put`, `rm`	Tenant object storage	storage
`orca memory list`, `search`, `show`, `delete`, `bank`, `bank stats`	Per-agent Memory Bank	memory
`orca keys list`, `create`, `revoke`	Tenant API keys	keys
`orca billing wallet`, `cap`, `cap set`	Wallet balance and spend cap	billing

Setup

Command	Description	Page
`orca login`, `orca auth login`, `auth status`, `auth logout`	Sign in and out	auth and context
`orca whoami`	Which tenant and role the stored key acts as	auth and context
`orca context list`, `use`, `show`	Named contexts	auth and context
`orca update`	Self-update the standalone binary	update
`orca help [command]`	Help for a command	update

Using the CLI

Command reference

Reference overview

Global flags

Conventions

Shared paging flags

Exit codes

Command index

Core

Observe

Manage

Setup

​Global flags

​Conventions

​Shared paging flags

​Exit codes

​Command index

​Core

​Observe

​Manage

​Setup

Global flags

Conventions

Shared paging flags

Exit codes

Command index

Core

Observe

Manage

Setup