docs.VoiceRun

VoiceRun CLI

The VoiceRun CLI (vr) is a command-line tool for creating, testing, deploying, and managing voice agents. It provides a complete developer workflow from project scaffolding to production deployment.

Version: 1.1.0

Installation#

Prerequisites#

  • Python 3.10+
  • uv (recommended) or pip

Via uv#

uv tool install voicerun-cli

Via pip#

pip install voicerun-cli

Verify Installation#

vr --version

Setup#

After installing, run the setup command to configure your environment:

vr setup

This installs required dependencies and configures integrations:

  • uv — Python package manager (used for agent projects)
  • Skills — Claude Code / Codex / OpenClaw skills for AI-assisted development
  • MCP server — Editor integration for Cursor, Windsurf, and other MCP-compatible editors

You can skip individual steps or target specific editors:

vr setup --skip-uv                 # Skip dependency installation
vr setup --claude-code             # Install skills to Claude Code only
vr setup --cursor                  # Configure MCP for Cursor only

Authentication#

Sign in to your VoiceRun account:

vr signin

Authentication supports three methods:

  • Browser (default) — Opens a browser window for OAuth sign-in
  • Email/Password — Non-interactive sign-in with --email and --password
  • API Key — Non-interactive sign-in with --api-key
vr signin --api-key YOUR_API_KEY
vr signin --email user@example.com --password yourpassword

To sign out and clear stored credentials:

vr signout

Updating#

Update the CLI to the latest version and refresh installed skills and MCP configurations:

vr --update

Next Steps#

overviewcliinstallationsetup