Vapi CLI

The official command-line interface for Vapi - Voice AI for developers.

Features

• 🔐 Authentication Management - Secure OAuth login, logout, and account switching
• 🤖 Assistant Management - List, create, update, and delete voice assistants
• 💬 Chat Management - Text-based conversations and chat history
• 📞 Enhanced Call Management - Full call lifecycle control and monitoring
• 📱 Phone Number Management - Purchase, configure, and manage phone numbers
• 🔄 Workflow Management - Manage visual conversation flows and branching logic
• 📣 Campaign Management - Create and manage AI phone call campaigns at scale
• 🛠️ Tool Management - Custom functions and API integrations
• 🔗 Webhook Management - Configure and manage real-time event delivery
• 🎧 Webhook Testing - Local webhook forwarding without ngrok
• 📋 Logs & Debugging - System logs, call logs, and error tracking
• 🔧 Project Integration - Auto-detect and integrate with existing projects
• 🚀 Framework Support - React, Vue, Angular, Next.js, Node.js, Python, Go, and more
• 📦 SDK Installation - Automatic SDK setup for your project type
• 🎨 Code Generation - Generate components, hooks, and examples
• ⬆️ Auto-Updates - Keep your CLI up-to-date with the latest features

Installation

Unix/Linux/macOS

curl -sSL https://vapi.ai/install.sh | bash

Windows

iex ((New-Object System.Net.WebClient).DownloadString('https://vapi.ai/install.ps1'))

Both scripts automatically detect your platform and install the latest version.

Docker

# Run directly
docker run -it ghcr.io/vapiai/cli:latest --help

# Or with persistent config
docker run -it -v ~/.vapi-cli.yaml:/home/vapi/.vapi-cli.yaml ghcr.io/vapiai/cli:latest assistant list

Manual Download

Download pre-built binaries from GitHub Releases:

# macOS/Linux
curl -sSL https://github.com/VapiAI/cli/releases/latest/download/cli_$(uname -s)_$(uname -m).tar.gz | tar xz
sudo mv vapi /usr/local/bin

# Or download specific version
curl -sSL https://github.com/VapiAI/cli/releases/download/v0.0.6/cli_Darwin_arm64.tar.gz | tar xz

From Source

# Clone the repository
git clone https://github.com/VapiAI/cli.git
cd cli

# Install dependencies
make deps

# Build the CLI
make build

# Install to ~/.local/bin
make install

Development Requirements

• Go 1.21+ - Install Go

• golangci-lint - For code linting

  # macOS
  brew install golangci-lint
  
  # Linux/Windows
  go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
  

Usage

Authentication

First, authenticate with your Vapi account:

vapi login

This will open your browser for secure authentication. Your API key will be saved locally.

Managing Authentication

For users who work with multiple organizations or need to switch accounts:

# Check current authentication status and list all accounts
vapi auth status

# Switch between multiple authenticated accounts
vapi auth switch [account-name]

# View current API key and source
vapi auth token

# View current user and organization info
vapi auth whoami

# Add another account (keeping existing ones)
vapi auth login

# Logout from current account
vapi auth logout

# Logout from all accounts
vapi auth logout --all

The CLI supports multiple accounts simultaneously, similar to GitHub CLI. This is perfect for:

• Working with multiple Vapi organizations
• Switching between production and staging environments
• Managing different client accounts
• Team collaboration with role-specific access

Assistant Management

# List all assistants
vapi assistant list

# Get assistant details
vapi assistant get <assistant-id>

# Create a new assistant (interactive)
vapi assistant create

# Delete an assistant
vapi assistant delete <assistant-id>

Workflow Management

# List all workflows
vapi workflow list

# Get workflow details
vapi workflow get <workflow-id>

# Create a new workflow (basic)
vapi workflow create

# Delete a workflow
vapi workflow delete <workflow-id>

Note: For visual workflow building with nodes and edges, use the Vapi Dashboard.

Campaign Management

# List all campaigns
vapi campaign list

# Get campaign details
vapi campaign get <campaign-id>

# Create a new campaign
vapi campaign create

# Update/end a campaign
vapi campaign update <campaign-id>

# Delete a campaign
vapi campaign delete <campaign-id>

Note: For advanced campaign features (customer lists, scheduling), use the Vapi Dashboard.

Project Integration

Initialize Vapi in your existing project:

# Auto-detect project type and set up Vapi
vapi init

# Initialize in a specific directory
vapi init /path/to/project

The init command will:

• Detect your project framework/language
• Install the appropriate Vapi SDK
• Generate example code and components
• Create environment configuration templates

MCP Integration - Turn Your IDE into a Vapi Expert

Set up Model Context Protocol (MCP) integration to give your IDE's AI assistant complete knowledge about Vapi:

# Auto-detect and configure all IDEs
vapi mcp setup

# Configure a specific IDE
vapi mcp setup cursor   # For Cursor
vapi mcp setup windsurf # For Windsurf
vapi mcp setup vscode   # For VSCode

# Check configuration status
vapi mcp status

Once configured, your IDE's AI assistant will have access to:

• Complete Vapi Documentation - No more hallucinated API info
• Code Examples & Templates - Real working examples
• Best Practices & Guides - Expert-level implementation patterns
• Latest Features - Always up-to-date with new releases

Supported IDEs:

• Cursor - AI-powered code editor
• Windsurf - Codeium's AI IDE
• VSCode - With GitHub Copilot

What this does:

• Configures your IDE to use the Vapi MCP docs server
• Creates appropriate configuration files (.cursor/mcp.json, etc.)
• Eliminates AI hallucination about Vapi features and APIs
• Enables intelligent code suggestions specific to Vapi

Try asking your IDE's AI: "How do I create a voice assistant with Vapi?" and watch it provide accurate, up-to-date information!

Configuration

# View current configuration
vapi config get

# Set configuration values
vapi config set <key> <value>

# List all configuration options
vapi config list

# Manage analytics preferences
vapi config analytics status   # Show current analytics status
vapi config analytics disable  # Disable analytics collection
vapi config analytics enable   # Enable analytics collection

Analytics and Privacy

The Vapi CLI collects anonymous usage analytics to help improve the product. We prioritize your privacy:

What we collect:

• Command usage patterns (anonymous)
• Error types and frequencies (hashed)
• Performance metrics
• Operating system and architecture
• CLI version information

What we DON'T collect:

• API keys or sensitive credentials
• File contents or personal data
• User-identifiable information
• Specific error messages (only hashed patterns)

How to opt out:

You can disable analytics collection in multiple ways:

# Via CLI command
vapi config analytics disable

# Via environment variable (any of these)
export VAPI_DISABLE_ANALYTICS=1
export VAPI_NO_TELEMETRY=1
export DISABLE_TELEMETRY=1
export DO_NOT_TRACK=1

# Via config file
echo "disable_analytics: true" >> ~/.vapi-cli.yaml

All data is collected anonymously and securely transmitted to PostHog for analysis.

Chat Management

Manage text-based chat conversations with Vapi assistants:

# List all chat conversations
vapi chat list

# Get chat conversation details
vapi chat get <chat-id>

# Create a new chat (guided setup)
vapi chat create

# Continue an existing chat conversation
vapi chat continue <chat-id> "Your message here"

# Delete a chat conversation
vapi chat delete <chat-id>

Phone Number Management

Manage your Vapi phone numbers for calls:

# List all phone numbers
vapi phone list

# Get phone number details
vapi phone get <phone-number-id>

# Purchase a new phone number (guided)
vapi phone create

# Update phone number configuration
vapi phone update <phone-number-id>

# Release a phone number
vapi phone delete <phone-number-id>

Enhanced Call Management

Enhanced call operations and monitoring:

# List all calls
vapi call list

# Get call details
vapi call get <call-id>

# Create a new call (guided)
vapi call create

# Update a call in progress
vapi call update <call-id>

# End an active call
vapi call end <call-id>

Logs and Debugging

View system logs for debugging and monitoring:

# List recent system logs
vapi logs list

# View call-specific logs
vapi logs calls [call-id]

# View recent error logs
vapi logs errors

# View webhook delivery logs
vapi logs webhooks

Tool Management

Manage custom tools and functions that connect your voice agents to external APIs:

# List all tools
vapi tool list

# Get tool details
vapi tool get <tool-id>

# Create a new tool (guided)
vapi tool create

# Update tool configuration
vapi tool update <tool-id>

# Delete a tool
vapi tool delete <tool-id>

# Test a tool with sample input
vapi tool test <tool-id>

# List available tool types
vapi tool types

Webhook Management

Manage webhook endpoints and configurations for real-time event delivery:

# List all webhook endpoints
vapi webhook list

# Get webhook details
vapi webhook get <webhook-id>

# Create a new webhook endpoint
vapi webhook create [url]

# Update webhook configuration
vapi webhoo