> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Config and utility commands - Omni CLI

> Manage CLI configuration profiles, and the agent-help and completion utility commands.

Manage CLI profiles. These commands don't require authentication.

<h2 id="init">
  omni config init
</h2>

Interactively create a new configuration profile. Prompts for a profile name, API endpoint, and authentication method. See [CLI authentication](/developers/cli/authentication) for more details about OAuth and API token authentication.

```bash theme={null}
omni config init
```

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.

<h2 id="login">
  omni config login
</h2>

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

```bash theme={null}
omni config login
omni config login <profile>
```

<h2 id="logout">
  omni config logout
</h2>

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

```bash theme={null}
omni config logout
omni config logout <profile>
```

<h2 id="show">
  omni config show
</h2>

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

```bash theme={null}
omni config show
```

<h2 id="use">
  omni config use
</h2>

Switch the default profile.

```bash theme={null}
omni config use <profile>
```

<h2 id="list">
  omni config list
</h2>

List configured profiles.

```bash theme={null}
omni config list
```

<h2 id="rename">
  omni config rename
</h2>

Rename a profile.

```bash theme={null}
omni config rename <old_name> <new_name>
```

<h2 id="delete">
  omni config delete
</h2>

Delete a profile.

```bash theme={null}
omni config delete <profile>
```

<h2 id="set-format">
  omni config set-format
</h2>

Set the profile's default output format, overriding the built-in `auto` default. Format must be one of `json`, `human`, `auto`.

See [output formats](/developers/cli/reference/output-formats) for more information.

```bash theme={null}
omni config set-format human
```

<h2 id="agent-help">
  omni agent-help
</h2>

Print a concise usage guide formatted for AI agents.

```bash theme={null}
omni agent-help
```

<h2 id="completion">
  omni completion
</h2>

Generate a shell autocompletion script for `bash`, `fish`, `powershell`, or `zsh`.

```bash theme={null}
omni completion zsh
```

Run `omni completion <shell> --help` for that shell's install instructions.

<Note>
  Every command in this group also accepts the [global flags](/developers/cli/reference/global-flags), including `--token`, `--profile`, `--format`, and `--compact`.
</Note>