agentvibes 2.0.9 → 2.0.12

package/RELEASE_NOTES.md

@@ -1,5 +1,417 @@
 # 🎤 AgentVibes Release Notes
 
+## 📦 v2.0.12 - Remote TTS & BMAD Command Fix (2025-01-10)
+
+### 🤖 AI Summary
+
+This patch release adds powerful remote TTS audio forwarding for WSL/remote server environments and fixes the missing `/agent-vibes:bmad` slash command. Users working on remote servers or WSL can now hear TTS audio on their local machine through SSH forwarding, while BMAD users can finally access the voice integration command that was previously undetected.
+
+### ✨ New Features
+
+#### Remote TTS Audio Forwarding
+- **SSH audio forwarding** - TTS audio plays on your local machine when working remotely
+- **Automatic detection** - Detects SSH_CONNECTION and forwards audio automatically
+- **Multiple forwarding methods**:
+  - OSC 52 clipboard (terminals supporting OSC sequences)
+  - HTTP server (Python-based local audio player)
+  - SSH tunnel (port forwarding setup)
+- **WSL compatibility** - Perfect for WSL users who want audio on Windows host
+- **Configuration guide** - New `docs/REMOTE_TTS_SETUP.md` with setup instructions
+- **Fallback support** - Gracefully falls back to local playback if forwarding fails
+
+**New Scripts:**
+- `.claude/hooks/play-tts-remote.sh` - Remote audio forwarding logic
+- `.claude/hooks/play-tts-local-wrapper.sh` - Local playback wrapper for HTTP method
+- `docs/REMOTE_TTS_SETUP.md` - Complete setup guide
+
+#### Enhanced Piper TTS Installation
+- **PATH detection** - Automatically finds Piper in `~/.local/bin` even if not in PATH
+- **Installation validation** - Verifies Piper installation success before proceeding
+- **Better error handling** - Clear messages when Piper isn't found
+- **Automatic voice download prompts** - Offers to download voice models after installation
+
+### 🐛 Bug Fixes
+
+#### BMAD Command Detection Fix
+- **Fixed**: `/agent-vibes:bmad` command not appearing in Claude Code slash command list
+- **Root Cause**: Missing YAML frontmatter and bash directive in command file
+- **Impact**: BMAD voice integration features are now accessible
+- **Added**:
+  - YAML frontmatter with description and argument-hint
+  - `!bash .claude/hooks/bmad-voice-manager.sh $ARGUMENTS` directive
+- **File**: `.claude/commands/agent-vibes/bmad.md`
+
+**What Was Broken:**
+```bash
+# Before: Command not found
+/agent-vibes:bmad status
+# Error: Unknown command
+
+# After: Works perfectly
+/agent-vibes:bmad status
+# ✅ BMAD voice plugin: ENABLED
+```
+
+### 🔧 Technical Changes
+
+#### Remote TTS Architecture
+**Main Router (`play-tts.sh`):**
+- Detects `$SSH_CONNECTION` environment variable
+- Routes to `play-tts-remote.sh` when SSH session detected
+- Falls back to local playback for non-SSH sessions
+
+**Forwarding Methods:**
+1. **OSC 52 (Clipboard)**:
+   - Encodes audio as base64
+   - Sends via OSC 52 escape sequence
+   - Requires terminal supporting OSC 52
+   - Best for: iTerm2, Windows Terminal, Hyper
+
+2. **HTTP Server**:
+   - Starts Python HTTP server on port 8765
+   - Serves audio files over SSH tunnel
+   - Opens browser to play audio
+   - Best for: All environments with Python
+
+3. **SSH Tunnel**:
+   - Uses SSH reverse tunnel (-R)
+   - Forwards audio files to local machine
+   - Requires SSH agent forwarding
+   - Best for: Advanced users
+
+**Configuration:**
+```bash
+# Set in .claude/tts-remote-method.txt (project-local)
+# or ~/.claude/tts-remote-method.txt (global)
+echo "http" > .claude/tts-remote-method.txt
+```
+
+#### Piper Installer Improvements
+**Modified: `.claude/hooks/piper-installer.sh`**
+- Added `~/.local/bin/piper` detection
+- Checks for execution permission
+- Validates installation with `piper --version`
+- Shows PATH instructions when Piper found but not in PATH
+- Auto-detects pipx installation directory
+
+**Modified: `src/installer.js`**
+- Enhanced Piper installation workflow
+- Added PATH detection before installation
+- Shows helpful PATH export command when needed
+- Validates Piper is accessible after installation
+
+### 📊 Files Changed
+
+**Added (3 files):**
+- `.claude/hooks/play-tts-remote.sh` (81 lines)
+- `.claude/hooks/play-tts-local-wrapper.sh` (44 lines)
+- `docs/REMOTE_TTS_SETUP.md` (190 lines)
+
+**Modified (5 files):**
+- `.claude/commands/agent-vibes/bmad.md` (8 insertions)
+- `.claude/hooks/play-tts.sh` (31 insertions)
+- `.claude/hooks/play-tts-piper.sh` (12 lines changed)
+- `.claude/hooks/piper-installer.sh` (58 insertions, 6 deletions)
+- `src/installer.js` (107 insertions, 6 deletions)
+
+**Total Changes:** 545 insertions, 13 deletions across 8 files
+
+### 🎯 User Impact
+
+**Before v2.0.12:**
+- Remote/WSL users couldn't hear TTS audio
+- `/agent-vibes:bmad` command was invisible
+- Piper installation didn't validate PATH
+- No remote audio forwarding options
+
+**After v2.0.12:**
+- Remote TTS works via SSH forwarding
+- BMAD command fully functional
+- Piper installer validates PATH and accessibility
+- Multiple forwarding methods for different environments
+- Complete setup guide for remote audio
+
+### 💡 Usage Examples
+
+#### Remote TTS Setup
+```bash
+# Quick setup for HTTP method (recommended)
+echo "http" > .claude/tts-remote-method.txt
+
+# On your LOCAL machine, create SSH tunnel:
+ssh -R 8765:localhost:8765 user@remote-server
+
+# Now TTS audio plays on your local machine!
+```
+
+#### BMAD Voice Integration
+```bash
+# Enable BMAD plugin
+/agent-vibes:bmad enable
+
+# Check status
+/agent-vibes:bmad status
+
+# Set custom voice for agent
+/agent-vibes:bmad set pm "Aria"
+
+# List all agent mappings
+/agent-vibes:bmad list
+```
+
+### 🔄 Migration Notes
+
+**For Remote/WSL Users:**
+1. Update AgentVibes: `npx agentvibes update`
+2. Read setup guide: `docs/REMOTE_TTS_SETUP.md`
+3. Choose forwarding method (HTTP recommended)
+4. Configure SSH tunnel for chosen method
+5. Enjoy TTS audio on local machine!
+
+**For BMAD Users:**
+- Update to v2.0.12 to access `/agent-vibes:bmad` command
+- No configuration changes needed
+- All existing BMAD voice mappings preserved
+
+**For All Users:**
+- No breaking changes
+- Remote TTS is optional (auto-detected)
+- Local TTS works exactly as before
+
+### 📝 Commits in This Release
+
+```
+ef99bda feat: add remote TTS audio forwarding support
+156feb7 feat: enhance Piper TTS installation and audio forwarding support
+```
+
+### 🙏 Credits
+
+- Thanks to WSL and remote server users who requested audio forwarding
+- Special appreciation to BMAD users who reported the missing command
+- Python HTTP server method inspired by similar remote audio solutions
+
+---
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+---
+
+## 📦 v2.0.10 - GitHub Star Reminder & Provider Fixes (2025-01-10)
+
+### 🤖 AI Summary
+
+This patch release adds a gentle daily GitHub star reminder system and fixes critical bugs in provider switching and output style commands. Users can now be reminded to star the project (once per day, easily disabled), the ElevenLabs provider switching now works correctly with proper language support for 30+ languages, and all documentation now shows the correct output style command `Agent Vibes` instead of the lowercase `agent-vibes`.
+
+### ✨ New Features
+
+#### Daily GitHub Star Reminder System
+- **Gentle reminders** - Shows once per day when using TTS
+- **Easy to disable** - Run `echo "disabled" > .claude/github-star-reminder.txt`
+- **Non-intrusive** - Beautiful formatted message with clear instructions
+- **Community support** - Encourages users to support the project
+- **Smart tracking** - Date-based reminder system prevents spam
+
+**Example Reminder:**
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⭐ Enjoying AgentVibes?
+
+   If you find this project helpful, please consider giving us
+   a star on GitHub! It helps others discover AgentVibes and
+   motivates us to keep improving it.
+
+   👉 https://github.com/paulpreibisch/AgentVibes
+
+   Thank you for your support! 🙏
+
+   💡 To disable these reminders, run:
+   echo "disabled" > .claude/github-star-reminder.txt
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+#### Piper TTS Installer Script
+- **Automated installation** - Created `.claude/hooks/piper-installer.sh`
+- **Platform detection** - Checks for WSL/Linux compatibility
+- **Dependency management** - Installs pipx automatically if needed
+- **Voice downloads** - Offers to download voice models after installation
+- **Clear instructions** - Provides next steps and usage guide
+
+### 🐛 Bug Fixes
+
+#### Provider Switching Function Fixes
+- **Fixed function name mismatch** - `get_current_language()` → `get_language_code()` in provider-commands.sh:102
+- **Fixed ElevenLabs language support** - `get_current_language()` → `get_language_code()` in play-tts-elevenlabs.sh:52
+- **Added language validation** - New `is_language_supported()` function validates provider/language compatibility
+- **Implemented language mapping** - Full 30+ language code mapping (spanish→es, french→fr, etc.)
+- **Provider switching works** - Users can now switch between ElevenLabs and Piper without errors
+
+**What Was Broken:**
+```bash
+# Before: Provider switching failed with "command not found" error
+/agent-vibes:provider switch elevenlabs
+# .claude/hooks/provider-commands.sh: line 102: get_current_language: command not found
+
+# After: Works perfectly
+/agent-vibes:provider switch elevenlabs
+# ✓ Provider switched to: elevenlabs
+```
+
+#### Output Style Command Correction
+- **Fixed installer** - Updated `src/installer.js` (2 locations)
+- **Fixed hooks** - Updated check-output-style.sh, personality-manager.sh, voice-manager.sh
+- **Correct command** - Changed `/output-style agent-vibes` → `/output-style Agent Vibes`
+- **Consistent docs** - All documentation now shows the correct command
+
+**Why This Matters:**
+The output style name is case-sensitive in Claude Code. The incorrect lowercase command would fail silently, preventing users from enabling TTS narration.
+
+### 🔧 Technical Changes
+
+#### GitHub Star Reminder Implementation
+**New Files:**
+- `.claude/hooks/github-star-reminder.sh` - Main reminder script with disable support
+- `.claude/github-star-reminder.txt` - Tracks last reminder date
+
+**Integration:**
+- Added to `play-tts.sh` router (runs before TTS playback)
+- Silent errors (2>/dev/null || true) prevent disruption
+- Project-local or global config support
+
+**Disable Options:**
+1. Echo "disabled" to reminder file
+2. Create `.claude/github-star-reminder-disabled.flag`
+3. Create `~/.claude/github-star-reminder-disabled.flag`
+
+#### Provider Command Fixes
+**Modified Functions:**
+- `provider-commands.sh`:
+  - Added `is_language_supported()` function (lines 15-42)
+  - Fixed `get_current_language()` call to `get_language_code()` (line 131)
+
+- `play-tts-elevenlabs.sh`:
+  - Fixed `get_current_language()` call to `get_language_code()` (line 52)
+  - Replaced `get_language_code_for_name()` with full case statement (lines 56-83)
+  - Supports all 30+ languages with ISO 639-1 codes
+
+**Language Code Mapping:**
+```bash
+case "$CURRENT_LANGUAGE" in
+  spanish) LANGUAGE_CODE="es" ;;
+  french) LANGUAGE_CODE="fr" ;;
+  german) LANGUAGE_CODE="de" ;;
+  italian) LANGUAGE_CODE="it" ;;
+  # ... 26 more languages
+  english|*) LANGUAGE_CODE="en" ;;
+esac
+```
+
+#### Output Style Updates
+**Files Modified:**
+- `src/installer.js` - Lines 588, 614
+- `.claude/hooks/check-output-style.sh` - Line 45
+- `.claude/hooks/personality-manager.sh` - Line 197
+- `.claude/hooks/voice-manager.sh` - Line 248
+
+All now correctly reference `/output-style Agent Vibes` instead of the incorrect lowercase version.
+
+### 🎯 User Impact
+
+**Before v2.0.10:**
+- Provider switching failed with cryptic "command not found" errors
+- Users couldn't switch between ElevenLabs and Piper
+- Documentation showed wrong output style command
+- No gentle reminder to support the project
+
+**After v2.0.10:**
+- Provider switching works seamlessly
+- Full 30+ language support with ElevenLabs
+- Correct output style command everywhere
+- Optional daily star reminder (easily disabled)
+- Piper TTS installer for easy setup
+
+### 📊 Files Changed
+
+**Added (3 files):**
+- `.claude/hooks/github-star-reminder.sh` (94 lines)
+- `.claude/hooks/piper-installer.sh` (144 lines)
+- `.claude/github-star-reminder.txt` (1 line)
+
+**Modified (8 files):**
+- `.claude/hooks/check-output-style.sh` (4 lines changed)
+- `.claude/hooks/personality-manager.sh` (4 lines changed)
+- `.claude/hooks/play-tts-elevenlabs.sh` (33 lines added)
+- `.claude/hooks/play-tts.sh` (3 lines added)
+- `.claude/hooks/provider-commands.sh` (31 lines added)
+- `.claude/hooks/voice-manager.sh` (4 lines changed)
+- `README.md` (4 lines changed)
+- `src/installer.js` (4 lines changed)
+
+**Test Updates (3 files):**
+- `test/helpers/test-helper.bash` (6 lines changed)
+- `test/unit/personality-manager.bats` (20 lines changed)
+- `test/unit/personality-voice-mapping.bats` (21 lines changed)
+- `test/unit/play-tts.bats` (9 lines removed)
+
+**Total Changes:** 347 insertions, 35 deletions across 15 files
+
+### 🔄 Migration Notes
+
+**For All Users:**
+- Update via `/agent-vibes:update` or `npx agentvibes update`
+- No breaking changes - all existing settings preserved
+- GitHub star reminder shows once per day (easily disabled)
+- Provider switching now works correctly
+
+**To Disable GitHub Star Reminders:**
+```bash
+echo "disabled" > .claude/github-star-reminder.txt
+```
+
+**To Install Piper TTS:**
+```bash
+.claude/hooks/piper-installer.sh
+```
+
+### 💡 What's Next
+
+The next release (v2.1.0) will focus on:
+- Enhanced Piper TTS voice management
+- Improved multilingual voice selection
+- Additional personality styles
+- BMAD plugin enhancements
+
+### 📝 Commits in This Release
+
+```
+869b1e8 feat: Add Piper TTS installer and improve GitHub star reminders
+a9f3b0b feat: Add daily GitHub star reminder system
+18c389e fix: Update output style command and provider switching functions
+07ee376 test: Remove flaky API key test
+5a1a78b test: Skip flaky API key test in CI environments
+4ff1075 Merge branch 'master' of github.com:paulpreibisch/AgentVibes
+73d8303 test: Update tests for provider-aware personality system
+ec21c34 docs: Update README to version v2.0.9 [skip ci]
+```
+
+### 🙏 Credits
+
+- Thanks to users who reported the provider switching issues
+- Special appreciation to the community for supporting AgentVibes
+- ElevenLabs team for their excellent multilingual API
+
+---
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+
+---
+
+# 🎤 AgentVibes Release Notes
+
 ## 📦 v2.0.9 - Installer Release Notes Fix (2025-01-07)
 
 ### 🤖 AI Summary

package/agentvibes.org/.claude/commands/agent-vibes/add.md

@@ -0,0 +1,21 @@
+---
+description: Add a new custom ElevenLabs TTS voice
+argument-hint: <voice_name> <voice_id>
+---
+
+Add a new custom ElevenLabs TTS voice to your voice library.
+
+Usage:
+- `/agent-vibes:add "My Custom Voice" abc123xyz456789`
+- `/agent-vibes:add Narrator KTPVrSVAEUSJRClDzBw7`
+
+The voice ID should be a 15-30 character alphanumeric string from your ElevenLabs account.
+
+To find your voice IDs:
+1. Go to https://elevenlabs.io/app/voice-library
+2. Click on a voice
+3. Copy the voice ID from the URL or settings
+
+After adding, you can switch to it with `/agent-vibes:switch "Voice Name"`
+
+!bash .claude/hooks/voice-manager.sh add $ARGUMENTS

package/agentvibes.org/.claude/commands/agent-vibes/agent-vibes.md

@@ -0,0 +1,68 @@
+---
+description: ElevenLabs TTS voice management commands
+---
+
+# 🎤 ElevenLabs Voice Management
+
+Manage your ElevenLabs text-to-speech voices with these commands:
+
+## Available Commands
+
+### `/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 Northern Terry`
+- `/agent-vibes:switch "Cowboy Bob"`
+
+### `/agent-vibes:get`
+Display the currently selected voice
+
+### `/agent-vibes:add <name> <voice_id>`
+Add a new custom voice from your ElevenLabs account
+- `/agent-vibes:add "My Voice" abc123xyz456`
+
+### `/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 `.claude/config/agentvibes.json`
+
+## Getting Voice IDs
+
+To add your own custom voices:
+1. Go to https://elevenlabs.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
+
+## Default Voices
+
+The system comes with these Character Voices from ElevenLabs:
+- Northern Terry, Grandpa Spuds Oxley, Ms. Walker
+- Ralf Eisend, Amy, Michael, Jessica Anne Bogart
+- Aria, Lutz Laugh, Dr. Von Fusion, Matthew Schmitz
+- Demon Monster, Cowboy Bob, Drill Sergeant
+
+Enjoy your TTS experience! 🎵

package/agentvibes.org/.claude/commands/agent-vibes/commands.json

@@ -0,0 +1,53 @@
+{
+  "namespace": "agent-vibes",
+  "commands": [
+    {
+      "name": "list",
+      "description": "List all available ElevenLabs voices"
+    },
+    {
+      "name": "preview",
+      "description": "Preview ElevenLabs voices by playing audio samples"
+    },
+    {
+      "name": "switch",
+      "description": "Switch to a different ElevenLabs voice"
+    },
+    {
+      "name": "whoami",
+      "description": "Display currently selected voice"
+    },
+    {
+      "name": "sample",
+      "description": "Play a sample with the current or specified voice"
+    },
+    {
+      "name": "replay",
+      "description": "Replay the last TTS message"
+    },
+    {
+      "name": "personality",
+      "description": "Manage AI personality settings"
+    },
+    {
+      "name": "sentiment",
+      "description": "Set temporary personality sentiment"
+    },
+    {
+      "name": "set-pretext",
+      "description": "Configure pre-TTS message text"
+    },
+    {
+      "name": "set-language",
+      "description": "Set TTS language for multilingual voices"
+    },
+    {
+      "name": "add",
+      "description": "Add a new personality"
+    },
+    {
+      "name": "get",
+      "description": "Get personality details"
+    }
+  ]
+}

package/agentvibes.org/.claude/commands/agent-vibes/get.md

@@ -0,0 +1,9 @@
+---
+description: Get the currently selected ElevenLabs TTS voice
+---
+
+Display the currently selected ElevenLabs TTS voice.
+
+This shows which voice is currently set as the default for TTS audio generation.
+
+!bash .claude/hooks/voice-manager.sh get

package/agentvibes.org/.claude/commands/agent-vibes/list.md

@@ -0,0 +1,13 @@
+---
+description: List available ElevenLabs TTS voices with optional filtering
+argument-hint: [first|last] [N]
+---
+
+List available ElevenLabs TTS voices.
+
+Usage examples:
+- `/agent-vibes:list` - Show all voices
+- `/agent-vibes:list first 5` - Show first 5 voices
+- `/agent-vibes:list last 3` - Show last 3 voices
+
+!bash .claude/hooks/voice-manager.sh list $ARGUMENTS

package/agentvibes.org/.claude/commands/agent-vibes/personality.md

@@ -0,0 +1,79 @@
+---
+description: Set or customize the personality style for TTS messages
+argument-hint: [personality_name|list|add|edit|get|reset]
+---
+
+# /agent-vibes:personality
+
+Set or customize the personality style for TTS messages.
+
+This command allows you to add character and emotion to your TTS announcements by applying personality modifiers to messages.
+
+## Usage
+
+```bash
+# Set a personality
+/agent-vibes:personality flirty
+/agent-vibes:personality sarcastic
+
+# List all personalities
+/agent-vibes:personality list
+
+# Add custom personality
+/agent-vibes:personality add cowboy "Howdy partner!" "Yeehaw!"
+
+# Show current personality
+/agent-vibes:personality get
+
+# Reset to normal
+/agent-vibes:personality reset
+```
+
+## Available Personalities
+
+- **normal** - Standard professional tone
+- **flirty** - Playful and charming
+- **angry** - Frustrated and irritated
+- **sassy** - Bold with attitude
+- **moody** - Melancholic and brooding
+- **funny** - Lighthearted and comedic
+- **sarcastic** - Dry wit and irony
+- **poetic** - Elegant and lyrical
+- **annoying** - Over-enthusiastic
+- **professional** - Formal and precise
+- **pirate** - Seafaring swagger
+- **robot** - Mechanical and precise
+- **surfer-dude** - Chill beach vibes
+- **millennial** - Internet generation speak
+- **zen** - Peaceful and mindful
+- **dramatic** - Theatrical flair
+- **crass** - Edgy and blunt
+- **random** - Picks a different personality each time!
+
+## Editing Personalities
+
+Each personality is stored as a markdown file in `.claude/personalities/`. You can:
+
+### Edit existing personalities:
+```bash
+/agent-vibes:personality edit flirty
+```
+This shows the file path - edit it directly to customize behavior.
+
+### Create new personalities:
+```bash
+/agent-vibes:personality add cowboy
+```
+Creates a new personality file, then edit it to customize.
+
+### Personality files contain:
+- **Prefix**: Text added before messages
+- **Suffix**: Text added after messages
+- **AI Instructions**: How the AI should speak
+- **Example Responses**: Sample messages
+
+Files are located in `.claude/personalities/[name].md`
+
+## Implementation
+
+!bash .claude/hooks/personality-manager.sh $ARGUMENTS

package/agentvibes.org/.claude/commands/agent-vibes/preview.md

@@ -0,0 +1,16 @@
+---
+description: Preview ElevenLabs TTS voices by playing audio samples
+argument-hint: [voice_name|first|last] [N]
+---
+
+Preview ElevenLabs TTS voices by playing audio samples.
+
+Usage examples:
+- `/agent-vibes:preview` - Preview first 3 voices (default)
+- `/agent-vibes:preview 5` - Preview first 5 voices
+- `/agent-vibes:preview Jessica` - Preview Jessica Anne Bogart voice
+- `/agent-vibes:preview "Northern Terry"` - Preview Northern Terry voice
+- `/agent-vibes:preview first 10` - Preview first 10 voices
+- `/agent-vibes:preview last 5` - Preview last 5 voices
+
+!bash .claude/hooks/voice-manager.sh preview $ARGUMENTS