elv
ElevenLabs operations
320 operations, one envelope
npm · eleven-agent-cli 0.1.0 (binary: elv)
source on GitHubunofficial, independent — not built or endorsed by ElevenLabs
The entire ElevenLabs API as a CLI — text-to-speech, transcription, music, sound effects, dubbing, voice cloning, conversational agents, usage, history. 320 operations behind one JSON envelope per command; audio and other large payloads land on disk with their paths returned in the envelope.
surface area exposed to the agent
12 aliases wrap the common workflows —
- tts
- stt
- music
- sfx
- voice-change
- voice-isolate
- dubbing
- voices
- agents
- models
- history
- usage
plus elv call <operation_id> for the other 308, same envelope and safety rails.
agentcalls elv or an alias
elvbudget guard · --dry-run · --yes gate
ElevenLabs APIthe one real network call
one JSON lineaudio/large payloads land on disk, path in the envelope
Install
npm — requires Node 22+
npm install -g eleven-agent-cliConfigure
Set the key, run the doctor, done.
- ELEVENLABS_API_KEY required
- get one at elevenlabs.io — sent only as a request header, never logged
verify your setup
elv config doctorHow it works
- The generic runner elv call <operation_id> invokes any of the 320 operations in the vendored OpenAPI spec; twelve thin aliases (tts, stt, music, sfx, dubbing, …) wrap the common workflows over the same runner.
- Built-in discovery: elv ops search / get / schema --example produces a runnable skeleton fully offline.
- Destructive ops, outbound calls, and key mutations refuse without --yes; a budget guard (--max-credits) blocks over-ceiling calls before any network request.
- Real charges are read back from the response header, not just estimated; the API key travels only as a header — never in args, logs, output, or files.
Pairs well with
exa-agentsame species: an entire vendor API as one disciplined, self-describing CLIdelegatelet a delegated lane produce narration and sound without touching your main context
Known limits
- Pre-1.0 and honestly labeled as such — active patching in the changelog.
- Dry-running a secret-create operation can still echo the secret’s value; documented, don’t do it.
Independent project; not affiliated with or endorsed by ElevenLabs.