Skip to content
Voice Agent CLI

Automation

Prefer RETELL_API_KEY in CI and short-lived automation. Do not print the key, .env, or saved config files.

Terminal window
result="$(vac retell agents list --fields agent_id,agent_name)"
printf '%s\n' "$result" | jq '.items[]'

Use the CLI as a JSON boundary:

  • Read stdout only when the exit status is zero.
  • Parse stderr as the structured error shape documented in Output contract.
  • Retry only when error.retryable is true.
  • Use --fields to reduce output when a command supports it.
  • Run vac retell <group> --help instead of assuming CRUD symmetry.

Bundled agent guidance

Section titled “Bundled agent guidance”

The repository and npm package include skills/voice-agent/SKILL.md for reusable agent workflows. Root AGENTS.md defines project development and release rules, while CLAUDE.md loads those same instructions for Claude Code.

For mutation workflows, inspect before editing, use --dry-run where available, and publish drafts explicitly:

Terminal window
vac retell prompts diff agent_123
vac retell prompts update agent_123 --dry-run
vac retell prompts update agent_123
vac retell agents publish agent_123