Skip to main content
Manage CLI profiles. These commands don’t require authentication.

​
omni config init

Interactively create a new configuration profile. Prompts for a profile name, API endpoint, and authentication method. See CLI authentication for more details about OAuth and API token authentication.
You can authenticate with OAuth or an API token:
  • OAuth opens a browser-based login flow. Approving the verified Omni CLI application creates a user-scoped credential for the profile.
  • API token stores the token in the profile. You can also set OMNI_API_TOKEN or pass --token to override the profile token.

​
omni config login

Authenticate a profile with browser-based OAuth. If you don’t provide a profile name, the CLI uses the default profile.

​
omni config logout

Clear OAuth tokens from a profile. If you don’t provide a profile name, the CLI uses the default profile.

​
omni config show

Display the current configuration. Tokens are redacted in the output.

​
omni config use

Switch the default profile.

​
omni config list

List configured profiles.

​
omni config rename

Rename a profile.

​
omni config delete

Delete a profile.

​
omni config set-format

Set the profile’s default output format, overriding the built-in auto default. Format must be one of json, human, auto. See output formats for more information.

​
omni agent-help

Print a concise usage guide formatted for AI agents.

​
omni completion

Generate a shell autocompletion script for bash, fish, powershell, or zsh.
Run omni completion <shell> --help for that shell’s install instructions.
Every command in this group also accepts the global flags, including --token, --profile, --format, and --compact.