Voice Agent CLI

Provider-neutral CLI for managing voice agents, calls, prompts, and related resources. Retell is the first and only provider today.

The package is voice-agent-cli. It requires Node.js 22 or newer and provides vac as the canonical binary plus voice-agent as an equivalent alias.

Install

npm install --global voice-agent-cli
vac --version
vac retell --help

Upgrade to the latest stable npm release later with:

vac upgrade

Authenticate with an environment variable or the interactive login:

export RETELL_API_KEY=your_api_key
vac retell agents list --fields agent_id,agent_name

# Or save provider-scoped credentials:
vac retell login

Develop from source

npm ci
npm run build
npm link
vac retell --help

Documentation

The documentation site covers installation, the provider model, Retell compatibility, prompt workflows, command reference, architecture, development, and releases.

• Read the documentation
• Documentation source
• Build the docs locally
• Agent skill

Validate

npm run typecheck
npm test
npm run build
npm run test:package

MIT. See LICENSE.