# elevenlabs
> Build and manage ElevenLabs voice agents as code from the terminal

## Summary
Official ElevenLabs CLI — manage voice agents as code with templates, bidirectional sync, branching, testing, and CI/CD-friendly non-interactive output.

## Capabilities
- Create voice agents from pre-built templates
- Bidirectional sync between local config and ElevenLabs platform
- Agent branching for staging/production workflows
- Push and pull agent configurations
- Manage webhooks and custom tools
- Create and run agent tests
- Generate embed widgets for deployment
- Non-interactive by default for agent and CI/CD use
- Secure credential storage via OS keychain

## When to Use
- You need to manage ElevenLabs voice agents from the terminal
- You want to treat voice agent configs as code in version control
- You need CI/CD deployment of voice agents
- You want to automate voice agent management from an AI agent

## When NOT to Use
- You don't have an ElevenLabs account
- You only need text-to-speech without agent management

## Key Flags
- `--human-friendly`: Enable rich interactive UI (non-interactive by default)
- `--dry-run`: Preview changes without applying them
- `--template`: Agent template: default, minimal, voice-only, text-only, customer-service, assistant
- `--branch`: Target a specific agent branch

## Usage Patterns
### Initialize a new agent project
```
elevenlabs agents init
```
Set up local agent configuration files

### Create an agent from template
```
elevenlabs agents add "Support Bot" --template customer-service
```
Create a new voice agent from a pre-built template

### Push changes to ElevenLabs
```
elevenlabs agents push --dry-run
```
Preview and sync local changes to the platform

### Pull remote changes
```
elevenlabs agents pull --update
```
Sync remote agent config to local files

## Input / Output
- **stdout**: Agent status, sync results, test output — non-interactive JSON by default

## Installation
- **npm**: `npm install -g @elevenlabs/cli`
- **npx**: `npx @elevenlabs/cli agents init`

---
Source: https://littlescripts.sh/tools/elevenlabs-cli