> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# ElevenLabs CLI

## Overzicht

Met de ElevenLabs CLI krijg je vanuit je terminal toegang tot je ElevenLabs-agents, waardoor je ze op nieuwe manieren kunt beheren:

* Sla agents als code op in je versiebeheersysteem
* Stel CI/CD-integratie in om je agents automatisch te deployen
* Geef je coding agent toegang tot en beheer over je spraakagenten

> **Liever meteen naar de code?**
>
> Bekijk de [volledige broncode en draag bij op GitHub](https://github.com/elevenlabs/cli).

> **Geen installatie nodig**
>
> Als je met Claude of een andere MCP-client werkt, biedt de [gehoste MCP- server](/docs/nl/eleven-agents/operate/hosted-mcp) tools voor agentbeheer zonder lokale
> installatie. Gebruik de CLI wanneer je agents in versiebeheer wilt; gebruik de gehoste MCP-server voor
> beheer via gesprekken.

## Installatie

Homebrew (macOS) en Scoop (Windows) zijn de aanbevolen installatiemethoden en leveren een zelfstandige binary.

**`Homebrew (macOS)`**

```bash title="Homebrew (macOS)"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop (Windows)`**

```powershell title="Scoop (Windows)"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

> **Tip**
>
> Werk je met een AI-code-assistent? Voer `elevenlabs generate-skills` uit in je project om voor elke
> commandogroep een `SKILL.md` naar `skills/` te schrijven, zodat je assistent alle mogelijkheden van de CLI kent
> zonder dat je documentatie hoeft te plakken. Gebruik `--output-dir` om ze ergens anders te plaatsen. Dit leest de eigen
> ingebouwde API-definitie van de CLI, dus er is geen API-sleutel nodig en het werkt offline — en het blijft afgestemd op
> de versie van de CLI die je hebt geïnstalleerd.

Na de installatie is de opdracht `elevenlabs` overal in je terminal beschikbaar.

## Snel aan de slag

### Initialiseer een nieuw project

```bash
elevenlabs agents init
```

Hiermee maak je de projectstructuur met configuratiemappen en registerbestanden.

### Verifieer je bij ElevenLabs

```bash
elevenlabs auth login
```

Hiermee wordt een browservenster geopend om je via OAuth te verifiëren. De CLI controleert de inloggegevens en slaat ze veilig op.

### Maak je eerste agent

```bash
elevenlabs agents add "My Assistant" --template assistant
```

Hiermee maak je een nieuwe agentconfiguratie met de assistant-template.

### Push naar het ElevenLabs-platform

```bash
elevenlabs agents push
```

Hiermee upload je je lokale agentconfiguratie naar het ElevenLabs-platform.

## Projectstructuur

De CLI maakt een gestructureerde projectmap:

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

## Verificatie

`elevenlabs auth login` slaat inloggegevens op in de sleutelring van je besturingssysteem — Keychain op macOS,
Credential Manager op Windows en de Secret Service op Linux. Als er geen sleutelring beschikbaar is,
valt de CLI terug op `~/.config/elevenlabs/auth-keyring.json` met machtigingen `0600`. Voer
`elevenlabs auth status` uit om te zien welke bron wordt gebruikt, en `elevenlabs auth logout` om de
opgeslagen vermelding te verwijderen.

Stel voor CI `ELEVENLABS_API_KEY` in de omgeving of in een `.env`-bestand in, in plaats van in te loggen.

### Verificatieopdrachten

**`Inloggen`**

```bash title="Inloggen"
elevenlabs auth login
```

**`Uitloggen`**

```bash title="Uitloggen"
elevenlabs auth logout
```

## Agentbeheer

### Agents maken

Maak agents met vooraf gebouwde templates:

```bash
elevenlabs agents add "Agent Name" [options]
```

**Opties:**

* `--template <type>`: Kies uit beschikbare templates (standaard: default)
* `--skip-upload`: Maak lokaal zonder naar het platform te uploaden

**Voorbeeld:**

```bash
elevenlabs agents add "Customer Support Bot" --template customer-service
```

### Templates

De CLI biedt zes vooraf gebouwde templates voor veelvoorkomende toepassingen:

#### default

Volledige configuratie met alle beschikbare velden, verstandige standaardwaarden, volledige ondersteuning voor spraak/tekst, widgetaanpassing en evaluatiecriteria.

#### minimal

Alleen essentiële velden, waaronder een basisprompt, taal, TTS en gespreksinstellingen.

#### voice-only

Geoptimaliseerd voor spraakinteracties met uitgeschakelde tekstinvoer en geavanceerde spraakinstellingen.

#### text-only

Gesprekken gericht op tekst, met uitgeschakelde spraakfuncties.

#### customer-service

Professionele empathische prompts, lage temperatuur (0.1), een duur van 30 minuten en evaluatiecriteria.

#### assistant

AI-assistent voor algemene doeleinden met gebalanceerde creativiteit (temperatuur 0.3) en veelzijdige ondersteuning voor spraak/tekst.

### Templateopdrachten

**`Beschikbare templates weergeven`**

```bash title="Beschikbare templates weergeven"
elevenlabs agents templates list
```

**`Templateconfiguratie weergeven`**

```bash title="Templateconfiguratie weergeven"
elevenlabs agents templates show <template>
```

### Synchronisatie

Houd je lokale configuraties gesynchroniseerd met het ElevenLabs-platform:

**`Alle agents pushen`**

```bash title="Alle agents pushen"
elevenlabs agents push
```

**`Wijzigingen bekijken (dry run)`**

```bash title="Wijzigingen bekijken (dry run)"
elevenlabs agents push --dry-run
```

### Status en monitoring

**`Agentstatus controleren`**

```bash title="Agentstatus controleren"
elevenlabs agents status
```

### Importeren en exporteren

**`Bestaande agents importeren`**

```bash title="Bestaande agents importeren"
elevenlabs agents pull
```

**`Specifieke agent importeren`**

```bash title="Specifieke agent importeren"
elevenlabs agents pull --agent <agent_id>
```

**`Agents bijwerken`**

```bash title="Agents bijwerken"
elevenlabs agents pull --update
```

**`Alle agents weergeven`**

```bash title="Alle agents weergeven"
elevenlabs agents list
```

> **Note**
>
> Standaard slaat `elevenlabs agents pull` agents over die al lokaal bestaan. Gebruik de vlag `--update`
> om lokale configuraties te overschrijven met externe wijzigingen die in de browser of via de API zijn aangebracht.

## Toolbeheer

De CLI ondersteunt twee typen tools om de mogelijkheden van agents uit te breiden:

### Webhooktools

HTTP API-integraties met configuratie voor authenticatie en time-outs:

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

### Clienttools

Rechtstreekse client-side-integraties:

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

## Widget genereren

Genereer HTML-embedcode voor integratie op het web:

```bash
elevenlabs agents widget embed <agent_id>
```

Dit levert HTML-code op zoals:

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

## Configuratiebestanden

### Structuur van de agentconfiguratie

Elke agentconfiguratie bevat:

```json
{
  "name": "Agent Name",
  "conversation_config": {
    "agent": {
      "language": "en",
      "prompt": {
        "prompt": "You are a helpful AI assistant.",
        "llm": "gemini-2.5-flash",
        "temperature": 0.0
      }
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "cjVigY5qzO86Huf0OWal",
      "agent_output_audio_format": "pcm_16000"
    },
    "asr": {
      "provider": "scribe_realtime",
      "quality": "high",
      "user_input_audio_format": "pcm_16000"
    },
    "conversation": {
      "text_only": false,
      "max_duration_seconds": 600,
      "client_events": ["audio", "interruption"]
    }
  },
  "platform_settings": {
    "widget": {
      "variant": "full",
      "placement": "bottom-right"
    }
  },
  "tags": []
}
```

### CI/CD-pipeline-integratie

```yml
# In your GitHub Actions workflow
- name: Deploy ElevenAgents agents
  run: |
    npm install -g @elevenlabs/cli
    export ELEVENLABS_API_KEY=${{ secrets.ELEVENLABS_API_KEY }}
    elevenlabs agents push --dry-run  # Preview changes
    elevenlabs agents push            # Deploy
    elevenlabs agents status          # Verify deployment
```