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

> Install Breeze CLI, log in, generate audio, automate agent workflows, and turn CLI commands into API requests.

Breeze CLI is the local command-line interface for creating audio, previewing voices, checking account state, generating API requests, and running agent-safe Video Lab workflows without leaving the terminal.

## Install

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

The installer prints a PATH hint when the install directory is not already available in your current shell.

If Codex, Claude Code, or another agent is installing Breeze CLI for you, install the matching Breeze skills in the same step:

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

Use `--with-skills claude` for Claude Code, or run `breeze skills install --target codex --yes` after a manual install.

## Start with audio

```bash theme={null}
breeze login
breeze tts "Hello from Breeze"
breeze voice list
breeze tts "Save this take as a file." -o hello.wav
```

## Move into code

When the sound is right, use `breeze curl` to turn the same workflow into a Developer API request. Use `--agent` when an AI coding agent, CI job, or shell script needs machine-readable output.

```bash theme={null}
breeze curl tts "Hello from Breeze" --voice voc_xeh3w54cqvnp --format mp3 -o hello.mp3
breeze voice list --agent
breeze diagnostics --agent
```

## Commands

| Command         | Purpose                                                                   |
| --------------- | ------------------------------------------------------------------------- |
| `breeze tts`    | Generate speech interactively, play it locally, or save it.               |
| `breeze curl`   | Generate a reproducible Developer API cURL request.                       |
| `breeze config` | Manage profiles, base URLs, API keys, and local settings.                 |
| `breeze video`  | Validate, inspect, and render Video Lab projects for agents.              |
| `--agent`       | Use JSON, quiet, non-interactive output for Codex, CI, and shell scripts. |

See [CLI reference](/cli/reference) for the command index, global flags, and detailed pages.

## Choose a path

<Columns cols={2}>
  <Card title="CLI quickstart" icon="rocket" href="/cli/quickstart">
    Install Breeze CLI, log in, and generate the first audio from your terminal.
  </Card>

  <Card title="Text to speech" icon="mic" href="/cli/reference/tts">
    Prototype voices, stream playback, save audio files, and pass agent-safe flags.
  </Card>

  <Card title="Scripting and agents" icon="bot" href="/cli/reference/scripting">
    Use JSON output, stable exit codes, capabilities discovery, and Breeze agent skills.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/cli/reference/troubleshooting">
    Fix install, login, update, network, timeout, and Video Lab dependency issues.
  </Card>
</Columns>