> ## Documentation Index > Fetch the complete documentation index at: https://docs.orcapods.ai/llms.txt > Use this file to discover all available pages before exploring further. # Reference overview > Global flags, shared conventions, and an index of every orca command. > **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](/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 ` | Use a named context from the config file instead of the current one. `ORCA_CONTEXT` does the same from the environment | | `--api-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 * `` 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 ` | integer | `10` | Page size (positive) | | `--offset ` | 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](/cli/output-and-scripting#pagination) for the exceptions. ## Exit codes `0` ok, `1` failure, `2` usage, `3` auth, `4` not found, `130` interrupted. Details in [Output and scripting](/cli/output-and-scripting#exit-codes). ## Command index ### Core | Command | Description | Page | | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------- | | `orca run [agent] [prompt...]` | Start a run and stream it | [run and chat](/cli/reference/run-and-chat) | | `orca chat [agent] [prompt...]` | Chat with a published agent through the public gateway | [run and chat](/cli/reference/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](/cli/reference/agents) | | `orca runs list` (paged), `get`, `cancel`, `tail` | Inspect and control runs | [runs](/cli/reference/runs) | ### Observe | Command | Description | Page | | ---------------------------------------------- | ---------------------------------------- | ------------------------------------------------- | | `orca stats`, `stats agents`, `stats hotspots` | Run and latency metrics over a window | [stats and usage](/cli/reference/stats-and-usage) | | `orca usage` | Token, cost, or run usage over a window | [stats and usage](/cli/reference/stats-and-usage) | | `orca sessions list` (paged), `get` | Session history | [sessions](/cli/reference/sessions) | | `orca doctor` | Connectivity and configuration checks | [platform](/cli/reference/platform) | | `orca topology` | Live view of the runner pool | [platform](/cli/reference/platform) | | `orca bundles` | Capability bundles agents can attach | [platform](/cli/reference/platform) | | `orca apps` | Connected Apps providers and connections | [platform](/cli/reference/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](/cli/reference/workflows) | | `orca pools list` (paged), `get`, `create`, `delete`, `members add`, `members remove` | Agent pools and membership | [pools](/cli/reference/pools) | | `orca skills list` (paged), `get`, `delete`, `import`, `attach`, `detach` | Skill catalog | [skills](/cli/reference/skills) | | `orca mcp serve`, `list` (paged), `get`, `add`, `set`, `remove`, `test`, `attach`, `detach` | MCP server catalog and the built-in MCP server | [mcp](/cli/reference/mcp) | | `orca secrets list` (paged), `set`, `delete` | Tenant secrets | [secrets](/cli/reference/secrets) | | `orca storage info`, `ls`, `browse`, `get`, `put`, `rm` | Tenant object storage | [storage](/cli/reference/storage) | | `orca memory list`, `search`, `show`, `delete`, `bank`, `bank stats` | Per-agent Memory Bank | [memory](/cli/reference/memory) | | `orca keys list`, `create`, `revoke` | Tenant API keys | [keys](/cli/reference/keys) | | `orca billing wallet`, `cap`, `cap set` | Wallet balance and spend cap | [billing](/cli/reference/billing) | ### Setup | Command | Description | Page | | ------------------------------------------------------------- | -------------------------------------------- | --------------------------------------------------- | | `orca login`, `orca auth login`, `auth status`, `auth logout` | Sign in and out | [auth and context](/cli/reference/auth-and-context) | | `orca whoami` | Which tenant and role the stored key acts as | [auth and context](/cli/reference/auth-and-context) | | `orca context list`, `use`, `show` | Named contexts | [auth and context](/cli/reference/auth-and-context) | | `orca update` | Self-update the standalone binary | [update](/cli/reference/update) | | `orca help [command]` | Help for a command | [update](/cli/reference/update) |