voice-chat

/voice-chat

Voice-controlled Claude Code. Speak your commands/questions, Claude processes them verbatim (as if you typed them), and responds with Inworld Olivia voice.

Usage

/voice-chat               # Start voice-controlled mode
/voice-chat stop          # Exit voice mode

Requirements (from .claude/voice-chat-requirements.md)

R1: Voice Input → Claude Code Verbatim

Your spoken words are transcribed and passed directly to Claude Code — exactly as if you typed them.

R2: Response in Inworld Olivia Voice

Claude Code's response is spoken using Inworld TTS with Olivia voice.

Prerequisites

1. voice-bridge server running with INWORLD_API_KEY set:

   cd ~/Documents/GitHub/voice-bridge
   VOICE_BACKEND=inworld INWORLD_API_KEY=<your-key> npm start
   

2. Microphone permissions granted

Instructions

Starting Voice Mode

When /voice-chat is invoked:

1. Announce start:

   mcp__voice-mcp__voice_speak({
     text: "Voice mode active. Speak your command.",
     voice_id: "Olivia",
     speed: 1.0
   })
   

2. Display: 🎤 **Listening...**

3. Listen for voice:

   mcp__voice-mcp__voice_listen({
     timeout_seconds: 30,
     language: "en-GB"
   })
   

4. Display the transcription: 👤 **You said:** "<transcribed text>"

5. CRITICAL: Process the transcribed text as if the user typed it directly.

   • Do NOT interpret it as a "voice chat question"
   • Execute it as a normal Claude Code command/request
   • Use all available tools (Read, Edit, Grep, Bash, etc.) as needed
   • Generate your normal response

6. Display speaking indicator: 🔊 **Speaking...**

7. Speak the response (or summary if long):

   mcp__voice-mcp__voice_speak({
     text: "<response or summary>",
     voice_id: "Olivia",
     speed: 1.0,
     wait: true
   })
   

8. Smart Output Router - Decide what to speak:

   Content Type	Action	Voice Says
   Short (< 100 words)	Speak fully	Full response
   Medium (100-300 words)	Display + announce	"Here's what I found"
   Long (> 300 words)	Display only	"Please read this"
   Contains code	Display + announce	"Here's the code"
   Contains table	Display + announce	"Here's a table"
   Error	Speak	Brief error description