Vocal Bridge Plugin for Claude Code
Manage your Vocal Bridge voice agents directly from Claude Code. View call logs, update prompts, stream debug events, and more.
Installation
From Marketplace (Recommended)
/plugin marketplace add vocalbridgeai/vocal-bridge-marketplace
/plugin install vocal-bridge@vocal-bridge
Manual Installation
# Clone the plugin
git clone https://github.com/vocalbridgeai/vocal-bridge-claude-plugin.git
# Load in Claude Code
claude --plugin-dir ./vocal-bridge-claude-plugin
Getting Started
-
Get your API key from your agent detail page or create an account key from the dashboard (paid subscribers)
-
Login to connect Claude Code to your agent:
/vocal-bridge:login vb_your_api_key_here
-
For account keys, select an agent to work with:
vb agent use
-
Verify connection:
/vocal-bridge:status
Commands
| Command | Description |
|---|
/vocal-bridge:login [api_key] | Authenticate with your API key |
/vocal-bridge:status | Check authentication status |
/vocal-bridge:agent | Show agent information |
/vocal-bridge:logs [session_id] | View call logs or session details |
/vocal-bridge:download <session_id> | Download call recording audio |
/vocal-bridge:stats | Show call statistics |
/vocal-bridge:prompt [show|set] | Manage system prompt |
/vocal-bridge:config [show|set|edit|options] | Manage all agent settings |
/vocal-bridge:create | Create and deploy a new agent (paid subscribers only) |
/vocal-bridge:delete [agent_id] | Delete an agent permanently |
/vocal-bridge:call <phone_number> | Place an outbound call (paid subscribers only) |
/vocal-bridge:eval <session_id> | Evaluate a call recording with a multimodal LLM (Pilot only, 100/day) |
/vocal-bridge:debug | Stream real-time debug events |
/vocal-bridge:setup | Install CLI if needed |
/vocal-bridge:help | Show all commands |
Examples
View Call Logs
# List recent calls
/vocal-bridge:logs
# Show last 50 failed calls
/vocal-bridge:logs -n 50 --status failed
# View specific call transcript
/vocal-bridge:logs 550e8400-e29b-41d4-a716-446655440000
Download Call Recordings
# Download recording for a session
/vocal-bridge:download 550e8400-e29b-41d4-a716-446655440000
# Download with custom filename
/vocal-bridge:download 550e8400-e29b-41d4-a716-446655440000 -o call.ogg
Manage Prompts
# View current prompt
/vocal-bridge:prompt show
# Update prompt (will guide you through the process)
/vocal-bridge:prompt set
Manage Agent Configuration
# View all agent settings
/vocal-bridge:config show
# View settings as JSON
/vocal-bridge:config show --json
# Export a config section as JSON
/vocal-bridge:config get model-settings
/vocal-bridge:config get client-actions
# Discover valid options for a setting (IMPORTANT: do this before changing settings)
/vocal-bridge:config options voice # by setting name
/vocal-bridge:config options "TTS Model" # by label (same as UI)
/vocal-bridge:config options audio # all settings in a category
# Update specific settings
/vocal-bridge:config set --style Focused
/vocal-bridge:config set --debug-mode true
/vocal-bridge:config set --hold-enabled true --hangup-enabled true
/vocal-bridge:config set --continuous-mode true # keep talking after silences (tutors, narrators)
# Partial update: merge file with current settings (only changes specified fields)
/vocal-bridge:config set --model-settings-file update.json --merge
# AI Agent integration
/vocal-bridge:config set --ai-agent-enabled true --ai-agent-description "Customer support agent"
/vocal-bridge:config set --ai-agent-file ai_agent.json
# Edit full configuration in $EDITOR
/vocal-bridge:config edit
Create New Agent (Paid Subscribers)
Create and deploy a new voice agent directly from Claude Code. Requires an active paid subscription. Maximum 50 agents per account.
# Create a simple chatty agent
/vocal-bridge:create --name "My Assistant" --style Chatty --prompt "You are a helpful assistant."
# Create with a greeting and web-only deployment
/vocal-bridge:create --name "Web Agent" --style Focused --prompt "You help users." --greeting "Hello!" --deploy-targets web
# Create from a prompt file
/vocal-bridge:create --name "Custom Agent" --style Chatty --prompt-file prompt.txt
Delete Agent
# Delete the currently selected agent (requires typing agent name to confirm)
/vocal-bridge:delete
# Delete a specific agent by ID
/vocal-bridge:delete 550e8400-e29b-41d4-a716-446655440000
# Skip confirmation (use with caution)
/vocal-bridge:delete --force
Outbound Calling (Paid Subscribers)
# Enable outbound calling (requires accepting Terms of Use)
/vocal-bridge:config set --outbound-enabled true --accept-outbound-tos
