ElevenLabs CLI

Overview

The ElevenLabs CLI allows you to access your ElevenLabs agents from your terminal, unlocking new ways to manage them:

• Store agents as code in your version control system
• Set up CI/CD integration to automatically deploy your agents
• Let your coding agent access and manage your voice agents

Installation

The CLI requires Node.js version 16.0.0 or higher.

$
npm install -g @elevenlabs/cli

After installation, the elevenlabs command will be available globally in your terminal.

Quick start

$
elevenlabs agents init

$
elevenlabs auth login

$
elevenlabs agents add "My Assistant" --template assistant

$
elevenlabs agents push

Project structure

The CLI creates a structured project directory:

your_project/
├── agents.json              # Central agent configuration registry
├── tools.json               # Tool definitions registry
├── tests.json               # Test definitions registry
├── agent_configs/           # Agent configuration files
├── tool_configs/            # Tool configuration files
└── test_configs/            # Test configuration files

Authentication

The CLI stores API keys in ~/.agents/api_keys.json file with restricted permissions (600).

Authentication commands

$
elevenlabs auth login

Agent management

Creating agents

Create agents using pre-built templates:

$
elevenlabs agents add "Agent Name" [options]

Options:

• --template <type>: Choose from available templates (default: default)
• --skip-upload: Create locally without uploading to platform

Example:

$
elevenlabs agents add "Customer Support Bot" --template customer-service

Templates

The CLI provides six pre-built templates for common use cases:

Template commands

$
elevenlabs agents templates list

Synchronization

Keep your local configurations synchronized with the ElevenLabs platform:

$
elevenlabs agents push

Status and monitoring

$
elevenlabs agents status

Import and export

$
elevenlabs agents pull

Tool management

The CLI supports two types of tools for extending agent capabilities:

Webhook tools

HTTP API integrations with authentication and timeout configuration:

$
elevenlabs tools add "API Integration" --type "webhook" --config-path ./config.json

Client tools

Direct client-side integrations:

$
elevenlabs tools add "Client Function" --type "client" --config-path ./config.json

Widget generation

Generate HTML embed code for web integration:

$
elevenlabs agents widget <agent_id>

This outputs HTML code like:

1
<elevenlabs-convai agent-id="agent_id_here"></elevenlabs-convai>
2
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async></script>

Configuration files

Agent configuration structure

Each agent configuration includes:

1
{
2
  "name": "Agent Name",
3
  "conversation_config": {
4
    "agent": {
5
      "language": "en",
6
      "prompt": {
7
        "prompt": "You are a helpful AI assistant.",
8
        "llm": "gemini-2.5-flash",
9
        "temperature": 0.0
10
      }
11
    },
12
    "tts": {
13
      "model_id": "eleven_turbo_v2",
14
      "voice_id": "cjVigY5qzO86Huf0OWal",
15
      "agent_output_audio_format": "pcm_16000"
16
    },
17
    "asr": {
18
      "provider": "scribe_realtime",
19
      "quality": "high",
20
      "user_input_audio_format": "pcm_16000"
21
    },
22
    "conversation": {
23
      "text_only": false,
24
      "max_duration_seconds": 600,
25
      "client_events": ["audio", "interruption"]
26
    }
27
  },
28
  "platform_settings": {
29
    "widget": {
30
      "variant": "full",
31
      "placement": "bottom-right"
32
    }
33
  },
34
  "tags": []
35
}

CI/CD pipeline integration

1
# In your GitHub Actions workflow
2
- name: Deploy ElevenAgents agents
3
  run: |
4
    npm install -g @elevenlabs/cli
5
    export ELEVENLABS_API_KEY=${{ secrets.ELEVENLABS_API_KEY }}
6
    elevenlabs agents push --dry-run  # Preview changes
7
    elevenlabs agents push            # Deploy
8
    elevenlabs agents status          # Verify deployment