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

# Breeze CLI quickstart

> Install Breeze CLI, log in with your Breeze account, and generate your first audio.

Breeze CLI installs locally, opens a browser for account login, and saves a device-specific API key in your `~/.breeze` profile. The key is shown to the CLI once during login and is stored locally for future commands.

## Install

```bash theme={null}
curl -fsSL https://breezeblue.ai/cli/install.sh | sh
```

If your current shell cannot find `breeze` after install, the installer prints the exact PATH command to run.

## Install agent skills

If you are installing Breeze CLI from Codex, Claude Code, or another AI agent harness, install the matching Breeze skills so the agent can discover the recommended CLI workflows.

```bash theme={null}
curl -fsSL https://breezeblue.ai/cli/install.sh | sh -s -- --with-skills codex
```

For Claude Code, use `--with-skills claude` instead. If you already installed Breeze CLI, add or refresh skills later:

```bash theme={null}
breeze skills install --target codex --yes
breeze skills check --target codex --agent
```

Skills install into the local agent skills directory and do not use your Breeze API key or call generation APIs. Manual users who do not use an AI agent can skip this step.

## Log in

`breeze login` opens your browser. After you approve the device, the CLI saves a key named `breeze-cli/<host>` for this machine. Use `--no-browser` when the terminal cannot open a browser.

```bash theme={null}
breeze login
```

## Generate your first audio

When no voice is provided, interactive text to speech picks a random visible voice for you. Add `-o` to save to a specific file. This command consumes account credits; check your balance with `breeze balance`.

```bash theme={null}
breeze tts "Hello from Breeze"
```

See [Breeze CLI overview](/cli) for core workflows, or [CLI reference](/cli/reference) for command details, scripting flags, config profiles, updates, and Video Lab automation.