versavoice-ai
v1.5.2
Published
Cross-lingual voice communication tools for AI coding agents — send messages in any language using your voice.
Maintainers
Readme
VersaVoice AI
Break language barriers — right from your IDE.
VersaVoice AI lets developers, AI Agents, and teams communicate across languages instantly. Send a message in English; your colleague reads it in Japanese. Record a voice note — it arrives spoken in your cloned voice, translated into their language. Connect with peers, customers, and loved ones without ever leaving your editor.
🎁 New accounts receive 5 minutes of free Neural Time — enough to experience the full translate and speak experience.
How It Works
┌──────────────────────────────────────────────────────────┐
│ YOUR IDE (Extension) │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Native LM │ │ File Proxy │ │ MCP Server │ │
│ │ Tools ¹ │ │ (Outbox) ² │ │ (SDK) ³ │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ └────────┬────────┘ │ │
│ │ │ │
│ ┌───────▼──────────┐ ┌─────────▼─────────┐ │
│ │ VersaVoice API │ │ VersaVoice API │ │
│ │ (in-process) │ │ (child process) │ │
│ └───────┬──────────┘ └─────────┬─────────┘ │
│ └──────────┬───────────────┘ │
└─────────────────────────────┼────────────────────────────┘
│
┌─────────▼──────────┐
│ VersaVoice AI │
│ Cloud Platform │
│ │
│ Translate · Speak │
│ Clone · Deliver │
└────────────────────┘Four tiers of agent access — the extension auto-detects what your IDE supports:
| Tier | Method | Requires | Best For |
|:-----|:-------|:---------|:---------|
| 1. Native Tools | vscode.lm.registerTool | Extension + reload | VS Code + Copilot, Antigravity* |
| 2. File Proxy | outbox.json → API | Extension only | Any IDE with extension |
| 3. MCP Server | Model Context Protocol | MCP config | Cursor, Windsurf, Claude Desktop |
| 4. cURL | Direct REST calls | API token | Any environment |
Features
Sidebar Panel
Your control centre for VersaVoice — expandable tree view with live data:
| Section | Shows | |:--------|:------| | Account | Display name, Neural Time balance, sub-account ID | | Contacts | Connected recipients with languages and UIDs | | Inbox | Recent messages with sender, text preview, and read status | | Config | Token status, IDE detection, Native LM Tools status, MCP status (VS Code, Cursor, Antigravity) |
AI Agent Messaging
Your AI agent can send and receive cross-lingual messages autonomously. Three modes:
| Mode | What Happens | Cost | |:-----|:-------------|:-----| | Typed | Sent as-is, no translation | Free | | Translate | AI-translated to recipient's language | Neural Time | | Speak | Translated + spoken in your cloned voice | Neural Time |
Inbox Polling
Background polling checks for new messages every 5 minutes. Messages are cached in .versavoiceai/inbox.json for agents to read.
Outbox File Proxy
Agents write to .versavoiceai/outbox.json with status: "pending" — the extension sends automatically and updates to "sent". Zero configuration, works everywhere.
Native LM Tools
In supported IDEs (Antigravity, VS Code), 11 tools are registered natively — agents call them directly without MCP configuration.
MCP Server
Full Model Context Protocol server with 11 tools. Auto-registers in VS Code; works standalone via npx for Cursor, Claude Desktop, and more.
Getting Started
- Download VersaVoice AI from the App Store or Google Play Store
- Create your account — new accounts receive 5 minutes of free Neural Time
- Generate an API token: Settings → General, tap "System" 5 times → API Access → Generate
Install the Extension
From Marketplace:
# Search "VersaVoice AI" in the Extensions panelFrom VSIX:
code --install-extension versavoice-ai-X.Y.Z.vsixSet Your Token
Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
VersaVoice: Set API TokenSet Up MCP Server (Optional)
Run "VersaVoice: Install MCP Server" from the Command Palette and pick your IDE:
- VS Code →
.vscode/mcp.json - Cursor →
.cursor/mcp.json - Antigravity →
~/.gemini/antigravity/mcp_config.json - All → writes to all configs
Standalone (no extension):
{
"mcpServers": {
"versavoice-ai": {
"command": "npx",
"args": ["-y", "versavoice-ai"],
"env": {
"VERSAVOICE_API_TOKEN": "<your-api-token>"
}
}
}
}Commands
| Command | Description |
|:--------|:------------|
| VersaVoice: Set API Token | Configure your API token |
| VersaVoice: Set Active Sub-Account | Select your AI assistant |
| VersaVoice: Show Account | View account details and balance |
| VersaVoice: Send Message | Send a cross-lingual message |
| VersaVoice: Check Inbox | View incoming messages |
| VersaVoice: Download Inbox | Download all messages to .versavoiceai/inbox.json |
| VersaVoice: List Sub-Accounts | View registered assistants |
| VersaVoice: Install Skill | Add communication skill for your AI agent |
| VersaVoice: Install MCP Server | Write MCP config for VS Code, Cursor, or Antigravity |
| VersaVoice: Refresh | Refresh sidebar and status bar |
Agent Tools (11)
Available via Native LM Tools (Tier 1), MCP Server (Tier 3), or cURL (Tier 4):
| Tool | Purpose |
|:-----|:--------|
| get_account | Sponsor identity, balance, sub-accounts |
| register_sub_account | Create an AI assistant identity |
| update_sub_account | Modify assistant profile |
| send_message | Send a cross-lingual message |
| get_inbox | Retrieve inbound messages |
| delete_message | Delete a specific message |
| list_connections | List available recipients |
| connect_sub_account | Connect assistant to a recipient |
| get_sub_account | Get assistant profile |
| api_manual | API reference guide + emotion tags |
| get_status | Pending / Active account status |
| delete_sub_account | Delete assistant and all data |
Configuration
Extension Settings
| Setting | Default | Description |
|:--------|:--------|:------------|
| versavoice.pollingIntervalMinutes | 5 | Inbox and balance polling interval |
| versavoice.balanceWarningSeconds | 600 | Low balance warning threshold |
Workspace Files
| File | Purpose |
|:-----|:--------|
| .versavoiceai/config.json | API token and sub-account settings |
| .versavoiceai/inbox.json | Cached inbound messages (agent-readable) |
| .versavoiceai/outbox.json | Agent message queue (write pending to send) |
Note: Add
.versavoiceai/to your.gitignoreto keep your API token out of version control.
Emotion Tags (Speak Mode)
Control the emotional delivery of voice messages:
[excited][laughs] We did it! [pauses] I can't believe it actually worked.Set customEmotionTags=true in send_message to use your own tags instead of AI auto-detection. Call get_usage for the full tag list.
Important Notes
- Sponsor is always connected: Sub-accounts can message the sponsor (primary account) immediately — no connection invitation needed
- Each account supports up to 20 AI assistant sub-accounts (configurable)
- To message other contacts, they must be API Enabled by the account owner, then connected via
connect_sub_account - Languages are auto-resolved from user profiles — no source/target config needed
- The extension and MCP server use the same API token but are configured independently
- Native LM Tools run in-process — no child process. Requires window reload after install.
- Antigravity uses the MCP Server (Tier 3) as its primary agent communication path. Configure via command palette or
~/.gemini/antigravity/mcp_config.json.
Links
- VersaVoice AI
- App Store
- Google Play Store (Coming Soon!)
License
Copyright © 2026 VersaVoice AI LLC. All rights reserved.
VersaVoice AI™ is a trademark of VersaVoice AI LLC.
