# CLI Commands

Every command a human runs at a terminal, in one place. Platform actions — `omni-cli <platform> <resource> <verb>` — are built for your agent: it reads the machine-readable catalog (`omni-cli discovery`) and emits them itself, so they aren't listed here; browse what your definition carries on the dashboard. Add `--help` to any command for its flags.

## Account & devices

Sign this machine in to OmniCLI. Details in [Install & Sign In](https://omnicli.io/docs/install.md).

| Command | What it does |
| --- | --- |
| `omni-cli account login` | Sign in this device through the browser (device flow). |
| `omni-cli account status` | Show the signed-in account and its devices. |
| `omni-cli account logout` | Deregister this device and clear its local credentials. |

## Platform credentials

Connect the platforms your definition carries. Details in [Platform Logins](https://omnicli.io/docs/platform-logins.md).

| Command | What it does |
| --- | --- |
| `omni-cli <platform> login --context work\|personal\|both` | Store a credential for the platform — prompts for a host, an account email, or a token as the platform requires. |
| `omni-cli <platform> status` | Show the platform's login state in each context, and the saved host. |
| `omni-cli <platform> logout` | Remove the stored credential (`--context` to target one). |

## Contexts

Keep `work` and `personal` credentials separate. Details in [Contexts](https://omnicli.io/docs/contexts.md).

| Command | What it does |
| --- | --- |
| `omni-cli context use work\|personal` | Set the global default context (`--clear` unsets it). |
| `omni-cli context status` | Show the resolved context, which resolution step won, and each platform's login state grouped by context. |
| `omni-cli context bind [dir] --context work\|personal` | Bind a directory (default: the current one) to a context. |
| `omni-cli context unbind [dir]` | Remove a directory binding (default: the current one). |
| `omni-cli context list` | List directory→context bindings. |

## Definitions

Inspect and refresh the catalog the CLI carries. Details in [Definitions](https://omnicli.io/docs/definitions.md).

| Command | What it does |
| --- | --- |
| `omni-cli definitions status` | Show the active definition, its refresh deadlines, and the frozen state. |
| `omni-cli definitions update` | Refresh the definition now — the way out of the frozen state. |

## Maintenance & information

| Command | What it does |
| --- | --- |
| `omni-cli self-update` | Download and install the latest omni-cli release. |
| `omni-cli version` | Show the build, the served API versions, and the active definition. |
| `omni-cli errors` | Print the exit-code catalog — every code and what it means. The same table as [Exit Codes](https://omnicli.io/docs/exit-codes.md). |
| `omni-cli discovery [platform] [action-id]` | The machine-readable JSON catalog agents read: platforms → one platform's actions → one action in full. See the [Discovery Contract](https://omnicli.io/docs/discovery-contract.md). |

## Global flags

These work on every command:

| Flag | What it does |
| --- | --- |
| `--context work\|personal` | Pin the context an action runs in (`both` is a login/logout idiom only). |
| `--json` | Machine-readable JSON output. |
| `--verbose` | Diagnostic logging to stderr (never secrets). |
| `--help` | Help for any command, platform, resource, or action. |
| `--version` | Print the CLI version (the `version` command shows more). |