Skip to main content
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

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.
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:
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.
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.
breeze tts "Hello from Breeze"
See Breeze CLI overview for core workflows, or CLI reference for command details, scripting flags, config profiles, updates, and Video Lab automation.