🎤 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 <voice_name>
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 <name> <voice_id>
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 <word>
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 <name>
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 <name>
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! 🎵