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

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

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

​
Generate your first audio

In an interactive terminal, text to speech picks a random visible voice when you do not pass one, and streams playback as soon as audio arrives. This command consumes account credits; check your balance with breeze balance.
Save a take as a file, or pick a specific voice:

​
Set up an AI agent

If Codex, Claude Code, or another coding agent uses Breeze CLI on this machine, install the matching Breeze agent skills so the agent discovers the recommended workflows:
Use --with-skills claude for Claude Code, or run breeze skills install --target codex --yes after a manual install. Skills are an explicit opt-in, install into the local agent skills directory, and never use your Breeze API key. Manual users can skip this step. See Scripting and agents.

​
Next steps

Text to speech

Streaming, formats, delivery instructions, async jobs, and realtime turns.

Voices

Browse, design, clone, and manage voices from the terminal.

From CLI to API

Turn any CLI workflow into a reproducible Developer API request.

Command reference

Every command, global flag, and environment variable.