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

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

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. 
breeze curl tts "Hello from Breeze" --voice voc_xeh3w54cqvnp --format mp3 -o hello.mp3
breeze voice list --agent
breeze diagnostics --agent

​
Commands

CommandPurpose
breeze ttsGenerate speech interactively, play it locally, or save it.
breeze curlGenerate a reproducible Developer API cURL request.
breeze configManage profiles, base URLs, API keys, and local settings.
breeze videoValidate, inspect, and render Video Lab projects for agents.
--agentUse JSON, quiet, non-interactive output for Codex, CI, and shell scripts.
See CLI reference for the command index, global flags, and detailed pages.

​
Choose a path

CLI quickstart

Install Breeze CLI, log in, and generate the first audio from your terminal.

Text to speech

Prototype voices, stream playback, save audio files, and pass agent-safe flags.

Scripting and agents

Use JSON output, stable exit codes, capabilities discovery, and Breeze agent skills.

Troubleshooting

Fix install, login, update, network, timeout, and Video Lab dependency issues.