🎤 AgentVibes Voice Management
Manage your text-to-speech voices across multiple providers (Piper TTS, Piper, macOS Say).
Available Commands
Voice Control
/agent-vibes:mute
Mute all TTS output (persists across sessions)
- Creates a mute flag that silences all voice output
- Shows 🔇 indicator when TTS would have played
/agent-vibes:mute
/agent-vibes:unmute
Unmute TTS output
- Removes mute flag and restores voice output
/agent-vibes:unmute
/agent-vibes:list [first|last] [N]
List all available voices, with optional filtering
/agent-vibes:list # Show all voices
/agent-vibes:list first 5 # Show first 5 voices
/agent-vibes:list last 3 # Show last 3 voices
/agent-vibes:preview [first|last] [N]
Preview voices by playing audio samples
/agent-vibes:preview # Preview first 3 voices
/agent-vibes:preview 5 # Preview first 5 voices
/agent-vibes:preview last 5 # Preview last 5 voices
/agent-vibes:switch
Switch to a different default voice
/agent-vibes:switch en_US-amy-medium
/agent-vibes:switch en_GB-alan-medium
/agent-vibes:switch fr_FR-siwis-medium
/agent-vibes:get
Display the currently selected voice
/agent-vibes:get
/agent-vibes:add
Add a new custom voice from your Piper TTS account
/agent-vibes:add "My Voice" abc123xyz456
See Getting Voice IDs section below.
/agent-vibes:replay [N]
Replay recently played TTS audio
/agent-vibes:replay # Replay last audio
/agent-vibes:replay 1 # Replay most recent
/agent-vibes:replay 2 # Replay second-to-last
/agent-vibes:replay 3 # Replay third-to-last
Keeps last 10 audio files in history.
/agent-vibes:set-pretext
Set a prefix word/phrase for all TTS messages
/agent-vibes:set-pretext AgentVibes # All TTS starts with "AgentVibes:"
/agent-vibes:set-pretext "Project Alpha" # Custom phrase
/agent-vibes:set-pretext "" # Clear pretext
Saved locally in .agentvibes/config/agentvibes.json
Provider Management
/agent-vibes:provider list
Show all available TTS providers
/agent-vibes:provider list
/agent-vibes:provider switch
Switch between providers
/agent-vibes:provider switch piper # Piper TTS - Free, offline, 50+ voices
/agent-vibes:provider switch macos # macOS Say - Native macOS voices (Mac only)
/agent-vibes:provider info
Get details about a specific provider
/agent-vibes:provider info piper
/agent-vibes:provider info macos
Providers
| Provider | Platform | Cost | Voices | Quality |
|---|---|---|---|---|
| Piper TTS | All platforms (Linux, macOS, WSL) | Free | 50+ in 30+ languages | ⭐⭐⭐⭐ |
| macOS Say | macOS only | Free (built-in) | 100+ system voices | ⭐⭐⭐⭐ |
On macOS, the native say provider is automatically detected and recommended!
Getting Voice IDs (Piper TTS)
To add your own custom Piper TTS voices:
- Go to https://piper.io/app/voice-library
- Select or create a voice
- Copy the voice ID (15-30 character alphanumeric string)
- Use
/agent-vibes:addto add it:
/agent-vibes:add "My Custom Voice" xyz789abc123def456
Default Voices
Piper TTS (Free & Offline)
English (US):
- en_US-lessac-medium (default male voice)
- en_US-amy-medium (friendly female)
- en_US-ryan-high (high quality male)
- en_US-libritts-high (multiple speakers)
English (UK):
- en_GB-alan-medium (British male)
- en_GB-jenny_dioco-medium (British female)
Romance Languages:
- es_ES-davefx-medium (Spanish - Spain)
- es_MX-claude-high (Spanish - Mexico)
- fr_FR-siwis-medium (French female)
- fr_FR-gilles-low (French male)
- it_IT-riccardo-x_low (Italian male)
- pt_BR-faber-medium (Portuguese - Brazilian)
Germanic Languages:
- de_DE-thorsten-medium (German male)
- de_DE-eva_k-x_low (German female)
Asian Languages:
- ja_JP-ayanami-medium (Japanese female)
- zh_CN-huayan-x_low (Chinese female)
- ko_KR-kss-medium (Korean female)
macOS Say (100+ Built-in)
- Samantha
- Alex
- Daniel
- Victoria
- Karen
- Moira
- And 100+ more system voices
Quick Examples
Switch to a different voice
/agent-vibes:switch en_US-lessac-medium # Clear male voice
/agent-vibes:switch en_US-ryan-high # High quality male
/agent-vibes:switch en_GB-alan-medium # British male
Preview before choosing
/agent-vibes:preview 5 # Preview first 5 voices
/agent-vibes:preview last 3 # Preview last 3 voices
Add your custom Piper voice
/agent-vibes:add "My Voice" abc123xyz456
/agent-vibes:switch My Voice
Switch providers
/agent-vibes:provider switch macos # Use native macOS voices
/agent-vibes:provider switch piper # Switch back to Piper
Mute/Unmute
/agent-vibes:mute # Silent mode
/agent-vibes:unmute # Restore voice
Tips & Tricks
- Preview first: Always use
/agent-vibes:previewbefore switching to a new voice - Provider switching: Some voices are only available on specific providers
- Voice history: Use
/agent-vibes:replayto hear the last 10 TTS messages - Custom pretext: Set a pretext to brand all your responses (e.g., "AgentVibes:")
- Mute for focus: Use
/agent-vibes:muteduring intensive work sessions
Enjoy your TTS experience! 🎵