cc-vox

Give Claude Code a voice.
Hear spoken summaries after every response — zero friction, multiple TTS backends.

✨ Features

• 🔊 Automatic voice feedback — Claude speaks a summary after every response
• 🎯 Multi-backend TTS — Qwen3-TTS, Fish Speech, Chatterbox (GPU), Kokoro (CPU), pocket-tts (zero setup)
• 🔄 Auto-detection — Picks the best available backend automatically
• 🎛️ Slash commands — Control voice, backend, personality on the fly
• 🗣️ 9 voices — Cross-backend voice mapping between Kokoro and pocket-tts
• ⚡ Zero config fallback — pocket-tts auto-starts via uvx, nothing to install
• 🧠 Smart GPU awareness — Skips GPU backends when your GPU is busy
• 🎭 Voice personality — Set prompts like "be chill" or "be upbeat"

🔁 How It Works

[!NOTE] The entire pipeline is hands-free. Once installed, Claude automatically includes voice summaries — no prompting required.

� Demo

┌─────────────────────────────────────────────────────────────────┐
│ $ claude                                                        │
│                                                                 │
│ You: refactor the auth module to use JWT tokens                 │
│                                                                 │
│ Claude: I've refactored the authentication module...            │
│ [... full response ...]                                         │
│                                                                 │
│ 📢 Done! I refactored auth to use JWT. Changed 3 files:        │
│    auth.py, middleware.py, and config.py. All tests pass.       │
│                                                                 │
│ 🔊 ████████████████████░░░░ Speaking...                        │
└─────────────────────────────────────────────────────────────────┘

The 📢 summary is extracted by the stop hook and spoken aloud through your chosen TTS backend.

🎙️ Backends

In auto mode (default), cc-vox tries Qwen3-TTS → Fish Speech → Chatterbox → Kokoro → pocket-tts and uses the first available. GPU backends are skipped when GPU utilization exceeds the threshold (default 80%).

🚀 Quick Start

1. Install the plugin

claude plugin marketplace add BestSithInEU/cc-vox
claude plugin install voice

2. Pick a backend

hf download kyutai/pocket-tts