🎤 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:

1. Go to https://piper.io/app/voice-library
2. Select or create a voice
3. Copy the voice ID (15-30 character alphanumeric string)
4. Use /agent-vibes:add to 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:preview before switching to a new voice
• Provider switching: Some voices are only available on specific providers
• Voice history: Use /agent-vibes:replay to 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:mute during intensive work sessions

Enjoy your TTS experience! 🎵