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.

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.

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.

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.

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.
`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.

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).

Read this page as markdown — the copy your coding agent fetches.