Connect CLI Reference

Connect CLI Reference

VoiceMode Connect commands for managing remote voice connections.

CLI Commands

Agents and humans use the same CLI interface:

voicemode connect up       # Start connection to voicemode.dev
voicemode connect down     # Stop connection
voicemode connect status   # Show connection status and devices
voicemode connect login    # Authenticate with voicemode.dev
voicemode connect logout   # Clear stored credentials

voicemode connect user add <name>    # Register an agent user
voicemode connect user list          # List registered users
voicemode connect user remove <name> # Remove an agent user

Prerequisites

All connect commands (except login/logout) require:

export VOICEMODE_CONNECT_ENABLED=true

VoiceMode does not connect to external services without explicit opt-in.

voicemode connect up

Start the connection to voicemode.dev. This is a long-running process that:

• Connects via WebSocket to the voicemode.dev gateway
• Announces registered users to the platform
• Watches for user configuration changes
• Delivers incoming messages to agent inboxes
• Reconnects automatically on disconnection

Requires authentication (voicemode connect login first).

voicemode connect status

Show current connection status, registered users, and connected remote devices.

VoiceMode Connect: enabled (not connected)
Gateway: wss://voicemode.dev/ws
Host: mba
Users:
  cora@mba (Cora 7)

voicemode connect user add

Register an agent user for remote voice:

voicemode connect user add cora --name "Cora 7"

Names must be lowercase, start with a letter.

Connect Configuration

voicemode.dev MCP Tools

The voicemode.dev platform also exposes MCP tools for agents connecting via mcp-remote. These are separate from the local CLI and documented at voicemode.dev.

See the voicemode.dev documentation for details on remote MCP tools.