Help Cpoepke Claude Talk

---
name: help
description: Show help for claude-talk voice chat commands.
disable-model-invocation: true
---

# Voice Chat Help

Display this help text to the user:

---

**claude-talk** - Voice conversation with Claude Code (macOS only)

### Quick Start
```
/claude-talk:install    # One-time setup + personalization
/claude-talk:start      # Start talking!
```

### Commands

| Command | Description |
|---------|-------------|
| `/claude-talk:install` | Install dependencies + choose name, voice, and personality |
| `/claude-talk:start` | Start voice chat with continuous listening |
| `/claude-talk:stop` | Stop voice chat session |
| `/claude-talk:mute` | Pause microphone capture |
| `/claude-talk:unmute` | Resume microphone capture |
| `/claude-talk:chat` | Quick single voice exchange |
| `/claude-talk:config` | View/edit settings (e.g., `/claude-talk:config VOICE=Karen`) |
| `/claude-talk:personality` | Manage personalities (list, create, switch, edit, delete) |
| `/claude-talk:teammate` | Spawn voice teammates |
| `/claude-talk:help` | Show this help |

### Requirements
- macOS with Apple Silicon (M1/M2/M3/M4)
- Python 3.12
- Working microphone

### Configuration
Settings are in `~/.claude-talk/config.env`. Key settings:
- `AUDIO_DEVICE` - Mic index (find with `python3 -c "import sounddevice; print(sounddevice.query_devices())"`)
- `MIC_GAIN` - Mic gain multiplier (built-in mic needs ~8.0, USB mics ~1.0)
- `KOKORO_VOICE` - Kokoro TTS voice ID (e.g., bm_daniel, af_heart)
- `KOKORO_SPEED` - TTS speed multiplier (default 1.0)

### Personalities
Manage multiple personalities with `/claude-talk:personality`:
- `/claude-talk:personality` — list all saved personalities
- `/claude-talk:personality create` — create a new personality
- `/claude-talk:personality switch <name>` — switch active personality
- `/claude-talk:personality edit [name]` — edit a personality
- `/claude-talk:personality delete <name>` — delete a personality
- `/claude-talk:personality export [name]` — print personality file
- `/claude-talk:personality import` — import from markdown or file

Personalities are saved in `~/.claude-talk/personalities/`. The active one is copied to `~/.claude-talk/personality.md`.

### Teammate Messaging
Once teammates are spawned, they can send each other text messages:
```
claude-talk message send <personality> "Hey, how's it going?"
claude-talk message broadcast "Listen up team!"
```
Messages arrive in the recipient's session as:
- `Teammate <name> said: <text>` (direct message)
- `Teammate <name> said to the team: <text>` (broadcast)

### Barge-In (interrupt TTS by speaking)
Requires BlackHole 2ch virtual audio device:
1. `brew install --cask blackhole-2ch`
2. Open Audio MIDI Setup → `+` → Create Multi-Output Device
3. Check "Built-in Output" (first) and "BlackHole 2ch" (no drift correction)
4. Set Multi-Output Device as system output

BlackHole is auto-detected. When available, you can interrupt TTS mid-sentence by speaking.

### Troubleshooting
- **No speech detected**: Check `AUDIO_DEVICE` index and `MIC_GAIN`
- **Whisper hallucinations**: Increase `MIC_GAIN` or adjust `VAD_AGGRESSIVENESS` (0-3)
- **Barge-in not working**: Ensure system output is set to Multi-Output Device (not just speakers)
- **Server won't start**: Check if another audio-server process is running

---