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

# Quickstart - Omni CLI

> Configure the Omni CLI and run your first commands.

This guide installs the Omni CLI, sets up a profile, authenticates, and runs your first commands.

## Requirements

To follow the steps in this guide, you'll need an Omni account. The CLI can authenticate with OAuth (recommended) or an API key; OAuth requires an Organization Admin to have enabled Personal Access Tokens first. See [CLI authentication](/developers/cli/authentication) for details on both methods.

## Steps

<Steps titleSize="h3">
  <Step title="Install the CLI">
    See the [CLI installation guide](/developers/cli/install).
  </Step>

  <Step title="Configure a profile">
    After you install the CLI, run:

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

    This creates a profile with a name, an API endpoint, and an authentication method. You can create multiple profiles for different organizations or environments.
  </Step>

  <Step title="Authenticate">
    Choose one of the following authentication methods:

    <Tabs>
      <Tab title="OAuth (recommended)" icon="trophy">
        Run the following command and authorize in your browser:

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

      <Tab title="API key" icon="key">
        Either enter your API token during `config init`, or set the environment variable:

        ```bash theme={null}
        export OMNI_API_TOKEN=omni_osk_...
        ```
      </Tab>
    </Tabs>

    See [CLI authentication](/developers/cli/authentication) for more details on both methods.
  </Step>

  <Step title="Run your first commands">
    ```bash theme={null}
    omni whoami whoami
    omni models list
    omni documents list
    omni --help
    ```

    * `omni whoami whoami` (yes, `whoami` twice: it's the `whoami` command group's own `whoami` subcommand) confirms your identity, key scope, and permissions without changing anything. It's a good first call after authenticating.
    * `omni models list` lists the models you can query.
    * `omni documents list` lists the workbooks and dashboards you can access.
    * `omni --help` lists every available command group.
  </Step>
</Steps>

## Next steps

* Install [agent skills](/developers/agent-skills)
* Learn about [Omni APIs](/api)