agentvibes 2.0.17-beta.7 → 2.0.17-beta.9

package/README.md

@@ -123,6 +123,20 @@ Instead of remembering slash commands like `/agent-vibes:switch Aria`, just say:
   - The MCP server will automatically install Python packages (mcp, pipx, Piper TTS)
   - But Python 3 itself must be installed first by you
 
+**Step 1: Set Your ElevenLabs API Key (Windows)**
+
+Open Command Prompt or PowerShell and run:
+```cmd
+setx ELEVENLABS_API_KEY "your-api-key-here"
+```
+
+**Important:** After running `setx`, you must:
+1. Close Claude Desktop completely (if running)
+2. Open a **new** terminal window (the variable won't be available in current terminal)
+3. Restart Claude Desktop
+
+**Step 2: Configure Claude Desktop**
+
 Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
 
 ```json
@@ -130,15 +144,14 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
   "mcpServers": {
     "agentvibes": {
       "command": "npx",
-      "args": ["-y", "agentvibes-mcp-server"],
-      "env": {
-        "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}"
-      }
+      "args": ["-y", "agentvibes@beta", "agentvibes-mcp-server"]
     }
   }
 }
 ```
 
+**Note:** The `env` section is optional. Claude Desktop automatically inherits Windows environment variables, so if you've set `ELEVENLABS_API_KEY` with `setx`, it will be available automatically.
+
 #### For Warp Terminal
 
 Add to `~/.warp/mcp.json`:
@@ -147,7 +160,7 @@ Add to `~/.warp/mcp.json`:
 {
   "agentvibes": {
     "command": "npx",
-    "args": ["-y", "agentvibes-mcp-server"],
+    "args": ["-y", "agentvibes@beta", "agentvibes-mcp-server"],
     "env": {
       "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}"
     }
@@ -164,7 +177,7 @@ Add to `.mcp-minimal.json` in your project:
   "mcpServers": {
     "agentvibes": {
       "command": "npx",
-      "args": ["-y", "agentvibes-mcp-server"],
+      "args": ["-y", "agentvibes@beta", "agentvibes-mcp-server"],
       "env": {
         "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}"
       }

package/RELEASE_NOTES_V2.md

@@ -91,6 +91,107 @@ AgentVibes now speaks **30+ languages** with native voice quality!
 
 ---
 
+### 🎓 Language Learning Mode (Beta)
+
+**Learn languages naturally with dual-language TTS!**
+
+AgentVibes now includes a **language learning mode** that helps you learn new languages through context and repetition. Every acknowledgment and completion is spoken TWICE - first in your main language (English), then in your target language.
+
+#### **How It Works:**
+
+1. **Set your target language** - Choose from 30+ supported languages
+2. **Enable learning mode** - Activates dual-language TTS
+3. **Natural repetition** - Hear everything twice in context
+4. **Adjustable speed** - Slow down target language for better comprehension
+
+#### **New Learning Commands:**
+
+```bash
+# Set the language you want to learn
+/agent-vibes:target spanish
+/agent-vibes:target french
+/agent-vibes:target german
+
+# Set voice for target language (auto-selected based on provider)
+/agent-vibes:target-voice Antoni          # ElevenLabs
+/agent-vibes:target-voice es_ES-davefx-medium  # Piper
+
+# Enable/disable learning mode
+/agent-vibes:learn
+
+# Set your main/native language
+/agent-vibes:language english
+
+# Adjust speech speed (Piper only)
+/agent-vibes:set-speed 2x          # 2x slower (great for learning)
+/agent-vibes:set-speed target 2x   # Slow down target language only
+/agent-vibes:set-speed normal      # Reset to normal speed
+```
+
+#### **Example Learning Session:**
+
+```
+User: "hello"
+
+Claude (English): "Hey there! Great to hear from you!"
+🔊 Plays in English with your configured voice
+
+Claude (Spanish): "¡Hola! ¡Qué bueno saber de ti!"
+🔊 Plays in Spanish with target voice (Antoni/es_ES-davefx-medium)
+```
+
+#### **Advanced Features:**
+
+**🎚️ Speech Rate Control (Piper TTS):**
+- Slow down target language for better comprehension
+- Separate speed controls for main and target languages
+- Intuitive syntax: `2x` = 2x slower, `0.5x` = 2x faster
+- Perfect for language learners who need more time to process
+
+**🔄 Mixed Provider Support:**
+- Use **ElevenLabs for English** (premium quality)
+- Use **Piper for Spanish** (free, slower speech)
+- System auto-detects provider from voice name
+- Seamless switching between providers
+
+**🎯 Auto-Voice Selection:**
+- System automatically selects the best voice for your target language
+- Provider-aware: ElevenLabs voices for ElevenLabs, Piper voices for Piper
+- Smart fallback if preferred voice unavailable
+
+**🌍 Supported Target Languages:**
+Spanish, French, German, Italian, Portuguese, Chinese, Japanese, Korean, Russian, Arabic, Hindi, Polish, Dutch, Turkish, Swedish, Danish, Norwegian, Finnish, Czech, Romanian, Ukrainian, Greek, Bulgarian, Croatian, Slovak, and more!
+
+#### **Voice Mappings by Provider:**
+
+**ElevenLabs Voices:**
+- Spanish → Antoni
+- French → Rachel
+- German → Domi
+- Italian → Bella
+- Portuguese → Matilda
+- Chinese, Japanese, Korean → Antoni (multilingual)
+
+**Piper Voices (Free, Offline):**
+- Spanish → es_ES-davefx-medium
+- French → fr_FR-siwis-medium
+- German → de_DE-thorsten-medium
+- Italian → it_IT-riccardo-x_low
+- Portuguese → pt_BR-faber-medium
+- Chinese → zh_CN-huayan-medium
+- Japanese → ja_JP-hikari-medium
+
+#### **Why This Helps Learning:**
+
+1. **Context-based learning** - Hear words/phrases in real situations
+2. **Natural repetition** - Every message twice, reinforcing vocabulary
+3. **Pronunciation practice** - Native-quality voices model correct pronunciation
+4. **Adjustable pace** - Slow down difficult phrases with speed control
+5. **Consistent exposure** - Learn while coding, naturally building vocabulary
+6. **No extra effort** - Learning happens passively as you work
+
+---
+
 ### 🎤 Expanded Voice Library (27+ Voices)
 
 **New multilingual voices added:**
@@ -269,6 +370,8 @@ sarcastic, flirty, pirate, grandpa, dry-humor, angry, robot, zen, professional,
 │   ├── provider-manager.sh      # Provider switching
 │   ├── provider-commands.sh     # Provider CLI
 │   ├── language-manager.sh      # Language system
+│   ├── learn-manager.sh         # Language learning mode
+│   ├── speed-manager.sh         # Speech rate control (Piper)
 │   ├── voice-manager.sh         # Voice switching
 │   ├── personality-manager.sh   # Personality system
 │   ├── sentiment-manager.sh     # Sentiment system
@@ -289,6 +392,12 @@ sarcastic, flirty, pirate, grandpa, dry-humor, angry, robot, zen, professional,
 - `tts-personality.txt` - Active personality
 - `tts-sentiment.txt` - Active sentiment
 - `tts-language.txt` - Selected language
+- `tts-learn-mode.txt` - Learning mode status (ON/OFF)
+- `tts-target-language.txt` - Target language for learning
+- `tts-target-voice.txt` - Voice for target language
+- `tts-main-language.txt` - Main/native language
+- `config/piper-speech-rate.txt` - Main voice speech rate (Piper)
+- `config/piper-target-speech-rate.txt` - Target voice speech rate (Piper)
 
 ---
 
@@ -315,6 +424,15 @@ sarcastic, flirty, pirate, grandpa, dry-humor, angry, robot, zen, professional,
 - `/agent-vibes:set-language list` - Show languages
 - `/agent-vibes:set-language english` - Reset to English
 
+### Language Learning Commands:
+- `/agent-vibes:target <language>` - Set target language to learn
+- `/agent-vibes:target-voice <voice>` - Set voice for target language
+- `/agent-vibes:learn` - Enable/disable learning mode
+- `/agent-vibes:language <language>` - Set main/native language
+- `/agent-vibes:set-speed <speed>` - Set speech rate (Piper only)
+- `/agent-vibes:set-speed target <speed>` - Set target language speed
+- `/agent-vibes:set-speed get` - Show current speed settings
+
 ### Personality Commands:
 - `/agent-vibes:personality <name>` - Set personality
 - `/agent-vibes:personality list` - Show all
@@ -407,6 +525,17 @@ sarcastic, flirty, pirate, grandpa, dry-humor, angry, robot, zen, professional,
 
 ## 🐛 Bug Fixes
 
+### v2.0.17-beta Series (Language Learning Mode):
+- **Fixed ElevenLabs audio static** - Added MP3 codec (`-c:a libmp3lame`) to prevent WAV format issues
+- **Fixed MCP provider switching** - Enhanced non-interactive detection with `CLAUDE_PROJECT_DIR` check
+- **Fixed target voice sync** - Auto-updates target voice when switching providers
+- **Fixed voice/provider mismatches** - Output style now lets system choose voice based on active provider
+- **Fixed learning mode config** - Corrected file names (`tts-learn-mode.txt`) and value checks (`ON`/`OFF`)
+- **Fixed Piper speech rate** - Properly reads numeric values from config files (strips comments)
+- **Fixed interactive prompts in MCP** - Provider switch commands now work seamlessly via slash commands
+- **Fixed Spanish voice download** - Voice models now download automatically with user consent
+
+### v2.0.0 Core Fixes:
 - Fixed symlink support for shared hooks
 - Fixed WSL audio static with silence padding
 - Fixed installer directory detection for npx
@@ -419,15 +548,17 @@ sarcastic, flirty, pirate, grandpa, dry-humor, angry, robot, zen, professional,
 
 ## 📊 Statistics
 
-**v2.0.0 by the numbers:**
+**v2.0.17-beta by the numbers:**
 - 🎤 **200+ voices** across both providers
-- 🌍 **30+ languages** supported
+- 🌍 **30+ languages** supported (learning mode for all)
+- 🎓 **1 language learning mode** with dual-language TTS
 - 🎭 **19 personalities** included
 - 💭 **19 sentiments** available
-- 📝 **15 slash commands** total
-- 🔧 **12 hook scripts** installed
-- 🔌 **2 TTS providers** available
+- 📝 **20+ slash commands** total (incl. learning commands)
+- 🔧 **14 hook scripts** installed (incl. learn-manager, speed-manager)
+- 🔌 **2 TTS providers** available (mixed provider support)
 - 🤖 **10 BMAD agents** with voice mapping
+- 🎚️ **Adjustable speech rate** for Piper TTS (0.5x - 3x)
 
 ---
 

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