agentvibes 1.1.3 → 2.0.1

package/README.md

@@ -2,14 +2,16 @@
 
 > **Bring your Claude Code sessions to life with voice!**
 >
-> Professional text-to-speech narration powered by ElevenLabs AI
+> 🌐 **[agentvibes.org](https://agentvibes.org)**
+>
+> Professional text-to-speech narration with multi-provider support - **ElevenLabs AI** or **Piper TTS (Free!)**
 
 [![npm version](https://badge.fury.io/js/agentvibes.svg)](https://badge.fury.io/js/agentvibes)
 [![Test Suite](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml)
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.0.0
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.0.1
 
 ---
 
@@ -43,11 +45,18 @@
 
 ## 📰 Latest Release
 
-**[v2.0.0 - Release Notes](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.0.0)** 📋
+**[v2.0.0 - The Multi-Provider Revolution](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.0.1)** 🎉
+
+The biggest update ever! **Multi-provider TTS support** (ElevenLabs + Piper TTS), **30+ languages**, expanded voice library (27+ voices), advanced sentiment system, enhanced BMAD integration, and comprehensive multilingual support. Choose between premium ElevenLabs voices or free offline Piper TTS!
 
-Symlink support & WSL audio fixes! Projects can now share hooks via symlinks while maintaining independent settings. Plus, WSL users get automatic silence padding to eliminate audio static.
+**Key highlights:**
+- 🎭 Multi-Provider Support - Switch between ElevenLabs (150+ voices) and Piper TTS (50+ free voices)
+- 🌍 30+ Languages - Speak in Spanish, French, German, Chinese, Japanese, and more
+- 🎤 27+ Professional Voices - Expanded voice library with multilingual support
+- 💬 Advanced Sentiment System - Apply personality styles to ANY voice
+- 🔌 Enhanced BMAD Plugin - Multilingual agent voices with personality mapping
 
-[→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
+[→ View Full Release Notes](RELEASE_NOTES_V2.md) | [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
 
 ---
 
@@ -59,13 +68,15 @@ Imagine Claude speaking to you with different voices and personalities as you co
 
 ### 🎯 Key Features
 
-- 🎙️ **17+ Professional AI Voices** - Character voices, accents, and unique personalities
+- 🎭 **Multi-Provider Support** - Choose ElevenLabs (150+ premium voices) or Piper TTS (50+ free voices)
+- 🌍 **30+ Languages** - Multilingual support with native voice quality
+- 🎙️ **27+ Professional AI Voices** - Character voices, accents, and unique personalities
 - 🎭 **19 Built-in Personalities** - From sarcastic to flirty, pirate to dry humor
-- 💬 **Sentiment System** - Apply personality styles to ANY voice
-- 🔌 **BMAD Plugin** - Auto voice switching for BMAD agents
-- 🔊 **Live Audio Feedback** - Hear task acknowledgments and completions
-- 🎵 **Voice Preview** - Listen before you choose
-- 🔄 **Audio Replay** - Replay the last 10 TTS messages
+- 💬 **Advanced Sentiment System** - Apply personality styles to ANY voice without changing it
+- 🔌 **Enhanced BMAD Plugin** - Auto voice switching for BMAD agents with multilingual support
+- 🔊 **Live Audio Feedback** - Hear task acknowledgments and completions in any language
+- 🎵 **Voice Preview & Replay** - Listen before you choose, replay last 10 TTS messages
+- 🆓 **Free Option Available** - Use Piper TTS with no API key required
 - ⚡ **One-Command Install** - Get started in seconds
 
 [↑ Back to top](#-table-of-contents)
@@ -100,9 +111,34 @@ npm install
 node bin/agent-vibes install
 ```
 
-### Step 2: Get Your ElevenLabs API Key
+### Step 2: Choose Your TTS Provider
+
+AgentVibes supports two TTS providers - pick the one that fits your needs:
+
+#### **Option A: Piper TTS (Free, Recommended for Getting Started)** 🆓
+
+**No setup required!** Piper TTS works out of the box with zero configuration.
+
+- ✅ Completely free, no API key needed
+- ✅ Works offline (perfect for Windows, WSL, Linux)
+- ✅ 50+ neural voices
+- ✅ 18 languages supported
+- ✅ Privacy-focused local processing
+
+**To use:** Just install AgentVibes and you're done! The installer will set Piper as default if no ElevenLabs key is detected.
 
-1. Sign up at [elevenlabs.io](https://elevenlabs.io/) (free tier available!)
+#### **Option B: ElevenLabs (Premium AI Voices)** 🎤
+
+**Best for production and variety.** Requires API key but offers 150+ premium voices.
+
+- ✅ 150+ professional AI voices
+- ✅ 30+ languages with multilingual v2
+- ✅ Studio-quality audio with emotional range
+- ✅ Character voices and unique personalities
+
+**Setup steps:**
+
+1. Sign up at [elevenlabs.io](https://elevenlabs.io/) (free tier: 10,000 chars/month)
 2. Copy your API key from the dashboard
 3. Add it to your environment:
 
@@ -112,6 +148,8 @@ echo 'export ELEVENLABS_API_KEY="your-api-key-here"' >> ~/.bashrc
 source ~/.bashrc
 ```
 
+**Switch providers anytime:** `/agent-vibes:provider switch`
+
 ### Step 3: Enable Voice in Claude Code
 
 ```bash
@@ -124,6 +162,117 @@ source ~/.bashrc
 
 ---
 
+## 🎭 Multi-Provider Support
+
+AgentVibes v2.0 introduces **multi-provider TTS support** - choose between premium ElevenLabs AI voices or free offline Piper TTS!
+
+### 🎤 ElevenLabs (Premium AI Voices)
+
+**Features:**
+- 150+ professional AI voices
+- 30+ languages with multilingual v2 model
+- Studio-quality audio with emotional range
+- Character voices, accents, and unique personalities
+- Voices include: Aria, Archer, Cowboy Bob, Pirate Marshal, Grandpa Spuds, Jessica Anne Bogart, and more!
+
+**Requirements:**
+- ElevenLabs API key (get free tier at [elevenlabs.io](https://elevenlabs.io))
+- Internet connection for API calls
+
+**Pricing (2025):**
+- Free: 10,000 chars/month (light use)
+- Starter: $5/month - 30,000 chars
+- Creator: $22/month - 100,000 chars
+- Pro: $99/month - 500,000 chars
+
+### 🆓 Piper TTS (Free, Offline)
+
+**Features:**
+- 50+ neural voices, completely free
+- 18 languages supported
+- No API key required
+- Works offline (perfect for Windows, WSL, and Linux)
+- Privacy-focused local processing
+- Cross-platform support (Windows, macOS, Linux)
+
+**Requirements:**
+- None! Works out of the box
+- Automatic voice download on first use
+- Native Windows support - no additional setup needed
+
+### Provider Commands
+
+```bash
+# View current provider
+/agent-vibes:provider info
+
+# List available providers
+/agent-vibes:provider list
+
+# Switch providers instantly
+/agent-vibes:provider switch
+
+# Test provider functionality
+/agent-vibes:provider test
+```
+
+### Switching Between Providers
+
+**During Installation:**
+The installer asks which provider you prefer and sets it up automatically.
+
+**After Installation:**
+```bash
+# Switch to Piper TTS (free)
+/agent-vibes:provider switch
+# Select: piper
+
+# Switch to ElevenLabs (premium)
+/agent-vibes:provider switch
+# Select: elevenlabs
+```
+
+**Automatic Fallback:**
+If ElevenLabs API key is missing, AgentVibes automatically falls back to Piper TTS.
+
+### Provider Comparison
+
+| Feature | ElevenLabs | Piper TTS |
+|---------|-----------|-----------|
+| **Voices** | 150+ premium AI | 50+ neural voices |
+| **Cost** | $0-99/month | Free forever |
+| **Quality** | Studio-grade | High-quality neural |
+| **Languages** | 30+ with multilingual v2 | 18 languages |
+| **Offline** | ❌ Requires internet | ✅ Works offline |
+| **API Key** | ✅ Required | ❌ Not needed |
+| **Emotional Range** | ✅ Advanced | ⚠️ Limited |
+| **Character Voices** | ✅ Extensive library | ⚠️ Standard voices |
+| **Platform Support** | All platforms | Windows, macOS, Linux, WSL |
+| **Best For** | Production, demos, variety | Development, privacy, Windows users |
+
+### Which Provider Should I Choose?
+
+**Choose ElevenLabs if:**
+- You want premium studio-quality voices
+- You need extensive character voice variety
+- You're creating demos or production content
+- You want advanced emotional range
+- You have a budget for API costs
+
+**Choose Piper TTS if:**
+- You want completely free TTS (especially great for Windows!)
+- You prefer offline/local processing
+- You're on Windows, WSL, or Linux
+- You value privacy and data control
+- You're in development/testing phase
+- You don't want to manage API keys or billing
+
+**Pro Tip:** Use Piper for development and ElevenLabs for production/demos!
+
+[↑ Back to top](#-table-of-contents)
+
+---
+
 ## 🎤 Commands Reference
 
 All commands are prefixed with `/agent-vibes:`
@@ -391,28 +540,46 @@ When you set a language, AgentVibes intelligently selects the best voice:
 your-project/
 └── .claude/
     ├── commands/
-    │   ├── agent-vibes/              # Voice commands
+    │   ├── agent-vibes/              # 15 voice commands
     │   └── agent-vibes-bmad.md       # BMAD plugin command
     ├── hooks/
+    │   ├── play-tts.sh               # Main TTS (provider-aware)
+    │   ├── play-tts-elevenlabs.sh    # ElevenLabs implementation
+    │   ├── play-tts-piper.sh         # Piper implementation
+    │   ├── provider-manager.sh       # Provider switching
+    │   ├── provider-commands.sh      # Provider CLI
+    │   ├── language-manager.sh       # Language system
     │   ├── voice-manager.sh          # Voice switching
     │   ├── personality-manager.sh    # Personality system
     │   ├── sentiment-manager.sh      # Sentiment system
-    │   ├── bmad-voice-manager.sh     # BMAD plugin
-    │   ├── play-tts.sh              # TTS playback
-    │   └── voices-config.sh         # Voice ID mappings
-    ├── personalities/               # 19 personality templates
+    │   ├── bmad-voice-manager.sh     # BMAD integration
+    │   ├── piper-voice-manager.sh    # Piper voices
+    │   ├── piper-download-voices.sh  # Piper downloader
+    │   └── voices-config.sh          # Voice ID mappings
+    ├── personalities/                # 19 personality templates
     ├── plugins/
-    │   └── bmad-voices.md           # BMAD voice mappings
+    │   └── bmad-voices.md            # BMAD voice mappings
     ├── output-styles/
-    │   └── agent-vibes.md           # Voice output style
-    └── audio/                       # Generated TTS files
+    │   └── agent-vibes.md            # Voice output style
+    └── audio/                        # Generated TTS files
 ```
 
 ### Voice Settings Storage
 
-- **Current Voice**: `~/.claude/tts-voice.txt`
-- **Current Personality**: `~/.claude/tts-personality.txt`
-- **Current Sentiment**: `~/.claude/tts-sentiment.txt`
+**Project-Local Settings** (`.claude/` in project):
+- **Current Provider**: `tts-provider.txt` - Active TTS provider (elevenlabs/piper)
+- **Current Voice**: `tts-voice.txt` - Selected voice name
+- **Current Personality**: `tts-personality.txt` - Active personality
+- **Current Sentiment**: `tts-sentiment.txt` - Active sentiment
+- **Current Language**: `tts-language.txt` - Selected language
+
+**Global Fallback** (`~/.claude/`):
+Settings fall back to global config if project-local doesn't exist.
+
+**How it works:**
+1. AgentVibes checks `.claude/` in current project first
+2. Falls back to `~/.claude/` if project setting doesn't exist
+3. This allows different voices/personalities per project!
 
 Settings persist across Claude Code sessions!
 
@@ -687,6 +854,38 @@ The update command will:
 
 ---
 
+## ⚠️ Important Disclaimers
+
+**API Costs & Usage:**
+- ElevenLabs usage may incur charges based on your subscription tier and character usage
+- Users are solely responsible for their own API costs and usage
+- Free tier: 10,000 characters/month | Paid plans: $5-99/month
+- See [ElevenLabs Pricing](https://elevenlabs.io/pricing) for current rates
+
+**Third-Party Services:**
+- This project integrates with ElevenLabs (TTS API) and Piper TTS (local processing)
+- We are **not affiliated with, endorsed by, or officially connected** to ElevenLabs, Anthropic, or Claude
+- ElevenLabs and Piper TTS are subject to their respective terms of service
+
+**Privacy & Data:**
+- **ElevenLabs**: Your text prompts are sent to ElevenLabs servers for processing
+- **Piper TTS**: All processing happens locally on your machine, no external data transmission
+- Review [ElevenLabs Privacy Policy](https://elevenlabs.io/privacy) for their data handling
+
+**Software License:**
+- Provided "as-is" under Apache 2.0 License without warranty of any kind
+- See [LICENSE](LICENSE) file for full terms
+- No liability for data loss, bugs, service interruptions, or any damages
+
+**Use at Your Own Risk:**
+- This is open-source software maintained by the community
+- Always test in development before production use
+- Monitor your API usage and costs regularly
+
+[↑ Back to top](#-table-of-contents)
+
+---
+
 ## 🙏 Credits
 
 **Built with ❤️ by [Paul Preibisch](https://github.com/paulpreibisch)**
@@ -696,12 +895,14 @@ The update command will:
 - 🌐 GitHub: [paulpreibisch](https://github.com/paulpreibisch)
 
 **Powered by:**
-- [ElevenLabs](https://elevenlabs.io/) AI voices
-- [Claude Code](https://claude.com/claude-code)
+- [ElevenLabs](https://elevenlabs.io/) - Premium AI voices
+- [Piper TTS](https://github.com/rhasspy/piper) - Free neural voices
+- [Claude Code](https://claude.com/claude-code) - AI coding assistant
 - Licensed under Apache 2.0
 
-**Inspired by:**
-- 💡 [Claude Code Hooks Mastery](https://github.com/disler/claude-code-hooks-mastery) by [@disler](https://github.com/disler)
+**Special Thanks:**
+- 💡 [Claude Code Hooks Mastery](https://github.com/disler/claude-code-hooks-mastery) by [@disler](https://github.com/disler) - Hooks inspiration
+- 🤖 [BMAD METHOD](https://github.com/bmad-code-org/BMAD-METHOD) - Multi-agent framework with auto voice switching integration
 
 [↑ Back to top](#-table-of-contents)
 

package/RELEASE_NOTES_V2.md

@@ -0,0 +1,482 @@
+**Release Date:** October 2025
+**Breaking Changes:** None - Fully backward compatible!
+
+---
+
+## 🚀 Major Features
+
+### 🎭 Multi-Provider TTS System
+
+The biggest update in AgentVibes history! **Choose your TTS provider** and switch seamlessly without reconfiguring.
+
+#### **Two Provider Options:**
+
+**🎤 ElevenLabs (Premium AI Voices)**
+- 150+ professional AI voices
+- 30+ languages with multilingual v2 model
+- Studio-quality audio with emotional range
+- Character voices, accents, and personalities
+- Voices: Aria, Archer, Cowboy Bob, Pirate Marshal, Grandpa Spuds, Jessica Anne Bogart, and more!
+
+**🆓 Piper TTS (Free, Offline)**
+- 50+ neural voices, completely free
+- 18 languages supported
+- No API key required
+- Works offline (perfect for WSL/Linux)
+- Privacy-focused local processing
+
+#### **New Provider Commands:**
+
+```bash
+# View current provider
+/agent-vibes:provider info
+
+# List available providers
+/agent-vibes:provider list
+
+# Switch providers instantly
+/agent-vibes:provider switch
+
+# Test provider functionality
+/agent-vibes:provider test
+```
+
+#### **Intelligent Provider Selection:**
+- **Interactive installer** asks which provider you prefer
+- **Automatic fallback** if API key missing
+- **Voice compatibility** - automatically maps voices to provider capabilities
+- **Persistent settings** - your choice is saved across sessions
+
+---
+
+### 🌍 Advanced Multilingual Support (30+ Languages)
+
+AgentVibes now speaks **30+ languages** with native voice quality!
+
+#### **Supported Languages:**
+- 🇪🇸 Spanish, 🇫🇷 French, 🇩🇪 German, 🇮🇹 Italian, 🇵🇹 Portuguese
+- 🇨🇳 Chinese, 🇯🇵 Japanese, 🇰🇷 Korean, 🇮🇳 Hindi, 🇸🇦 Arabic
+- 🇵🇱 Polish, 🇳🇱 Dutch, 🇹🇷 Turkish, 🇸🇪 Swedish, 🇷🇺 Russian
+- And 15+ more!
+
+#### **New Language Commands:**
+
+```bash
+# Set language for TTS
+/agent-vibes:set-language spanish
+/agent-vibes:set-language french
+/agent-vibes:set-language german
+
+# List all supported languages
+/agent-vibes:set-language list
+
+# Check current language
+/agent-vibes:whoami
+
+# Reset to English
+/agent-vibes:set-language english
+```
+
+#### **Smart Voice Selection:**
+- **Language-optimized voices** - Auto-switches to Antoni (Spanish), Rachel (French), Domi (German), Bella (Italian)
+- **BMAD integration** - Agents speak in your chosen language
+- **Personality support** - All 19 personalities work in any language
+- **Provider-aware** - Works with both ElevenLabs and Piper TTS
+
+#### **Language Priority System:**
+1. BMAD Agent + Language Set → Uses multilingual version of agent voice
+2. BMAD Agent only → Uses agent's default voice (English)
+3. Language Set only → Switches to language-optimized voice
+4. Neither → Uses current voice/personality
+
+---
+
+### 🎤 Expanded Voice Library (27+ Voices)
+
+**New multilingual voices added:**
+
+| Voice | Character | Languages | Best For |
+|-------|-----------|-----------|----------|
+| **Antoni** | Well-balanced | 30+ | Spanish, International |
+| **Rachel** | Clear, professional | 30+ | French, Global communication |
+| **Domi** | Strong, confident | 30+ | German, Leadership |
+| **Bella** | Soft, engaging | 30+ | Italian, Friendly |
+| **Charlotte** | Expressive | 30+ | French, German, Spanish |
+| **Matilda** | Warm | 30+ | Spanish, Portuguese |
+
+**Enhanced English character voices:**
+- Juniper, Tiffany, Tom (Team coordination)
+- Ralf Eisend (International)
+- Amy (Chinese accent)
+- Lutz Laugh (Jovial)
+- Burt Reynolds (Smooth baritone)
+- Demon Monster (Dramatic)
+
+---
+
+### 💭 Advanced Sentiment System
+
+**Apply personality styles to ANY voice** without changing it!
+
+#### **How It Works:**
+- **Personality** = Voice + Style (e.g., Pirate Marshal + pirate speak)
+- **Sentiment** = Your Voice + Style (e.g., Aria + sarcasm)
+
+#### **New Sentiment Commands:**
+
+```bash
+# Apply sentiment to current voice
+/agent-vibes:sentiment sarcastic
+/agent-vibes:sentiment flirty
+/agent-vibes:sentiment zen
+
+# List all sentiments
+/agent-vibes:sentiment list
+
+# Check current sentiment
+/agent-vibes:sentiment get
+
+# Remove sentiment
+/agent-vibes:sentiment clear
+
+# Combine voice + sentiment
+/agent-vibes:switch Aria --sentiment sarcastic
+```
+
+#### **All 19 Sentiments Available:**
+sarcastic, flirty, pirate, grandpa, dry-humor, angry, robot, zen, professional, dramatic, millennial, surfer-dude, sassy, poetic, moody, funny, annoying, crass, normal, random
+
+---
+
+### 🔌 Enhanced BMAD Plugin Integration
+
+**Auto-voice switching for multi-agent workflows** - now with language support!
+
+#### **What's New:**
+
+**🌍 Multilingual BMAD Agents:**
+- Set language, activate agent → Agent speaks in that language
+- Intelligent voice fallback if agent's voice doesn't support language
+- All 10 BMAD agents work in 30+ languages
+
+**🎭 Per-Agent Personality:**
+```bash
+# Set agent with custom personality
+/agent-vibes-bmad set pm "Jessica Anne Bogart" zen
+/agent-vibes-bmad set dev "Matthew Schmitz" sarcastic
+```
+
+**📊 Enhanced Status Display:**
+```bash
+/agent-vibes-bmad status  # Shows all mappings + current language
+```
+
+#### **Default BMAD Voice Mappings:**
+
+| Agent | Role | Voice | Personality |
+|-------|------|-------|-------------|
+| pm | Product Manager | Jessica Anne Bogart | professional |
+| dev | Developer | Matthew Schmitz | normal |
+| qa | QA Engineer | Burt Reynolds | professional |
+| architect | Architect | Michael | normal |
+| po | Product Owner | Tiffany | professional |
+| analyst | Analyst | Ralf Eisend | normal |
+| sm | Scrum Master | Ms. Walker | professional |
+| ux-expert | UX Expert | Aria | normal |
+| bmad-master | BMAD Master | Archer | zen |
+| bmad-orchestrator | Orchestrator | Tom | professional |
+
+---
+
+### 🎵 Audio Management Features
+
+#### **Voice Preview System:**
+```bash
+/agent-vibes:preview           # Hear first 3 voices
+/agent-vibes:preview 10        # Hear first 10
+/agent-vibes:preview last 5    # Hear last 5
+```
+
+#### **Audio Replay:**
+```bash
+/agent-vibes:replay     # Replay last message
+/agent-vibes:replay 3   # Replay 3rd-to-last
+```
+
+#### **Voice Testing:**
+```bash
+/agent-vibes:sample Aria              # Test specific voice
+/agent-vibes:sample "Cowboy Bob"      # Test with custom text
+```
+
+---
+
+### ⚙️ Enhanced Installation & Updates
+
+#### **Interactive Installer:**
+- **Provider selection** during install
+- **API key detection** and setup guidance
+- **Piper TTS option** with automatic voice download
+- **Visual progress** with ora spinners
+- **Release notes display** showing latest changes
+
+#### **Self-Update System:**
+```bash
+/agent-vibes:update         # Update with confirmation
+/agent-vibes:update --yes   # Auto-confirm update
+/agent-vibes:version        # Check installed version
+```
+
+#### **Update Features:**
+- ✅ Updates all commands and hooks
+- ✅ Adds new personalities (preserves custom ones)
+- ✅ Shows release notes and commit history
+- ✅ Preserves your settings and configurations
+- ✅ Provider-aware (updates both ElevenLabs & Piper files)
+
+---
+
+### 🛠️ System Improvements
+
+#### **Symlink Support:**
+- Share hooks across projects via symlinks
+- Maintain independent settings per project
+- Project-local `.claude/` takes precedence over symlinks
+
+#### **WSL Audio Fixes:**
+- Automatic silence padding prevents audio static
+- Enhanced audio playback for WSL2 users
+- Cross-platform audio improvements
+
+#### **GitHub Actions Integration:**
+- Automated release creation
+- Categorized release notes (feat/fix/chore)
+- README auto-updates on release
+- Comprehensive changelog generation
+
+---
+
+## 📦 What's Included
+
+### Installation Structure:
+```
+.claude/
+├── commands/agent-vibes/        # 15 slash commands
+├── hooks/
+│   ├── play-tts.sh             # Main TTS (provider-aware)
+│   ├── play-tts-elevenlabs.sh  # ElevenLabs implementation
+│   ├── play-tts-piper.sh       # Piper implementation
+│   ├── provider-manager.sh      # Provider switching
+│   ├── provider-commands.sh     # Provider CLI
+│   ├── language-manager.sh      # Language system
+│   ├── voice-manager.sh         # Voice switching
+│   ├── personality-manager.sh   # Personality system
+│   ├── sentiment-manager.sh     # Sentiment system
+│   ├── bmad-voice-manager.sh    # BMAD integration
+│   ├── piper-voice-manager.sh   # Piper voices
+│   └── piper-download-voices.sh # Piper downloader
+├── personalities/               # 19 personality templates
+├── plugins/
+│   └── bmad-voices.md          # BMAD mappings
+├── output-styles/
+│   └── agent-vibes.md          # Voice output style
+└── audio/                      # Generated TTS files
+```
+
+### Settings Storage:
+- `tts-provider.txt` - Active provider (elevenlabs/piper)
+- `tts-voice.txt` - Current voice
+- `tts-personality.txt` - Active personality
+- `tts-sentiment.txt` - Active sentiment
+- `tts-language.txt` - Selected language
+
+---
+
+## 🎯 Complete Command Reference
+
+### Voice Commands:
+- `/agent-vibes:list` - Show all voices
+- `/agent-vibes:switch <voice>` - Change voice
+- `/agent-vibes:whoami` - Show current setup
+- `/agent-vibes:preview [N]` - Preview voices
+- `/agent-vibes:sample <voice>` - Test voice
+- `/agent-vibes:add <name> <id>` - Add custom voice
+- `/agent-vibes:replay [N]` - Replay audio
+- `/agent-vibes:get` - Get current voice
+
+### Provider Commands:
+- `/agent-vibes:provider switch` - Change TTS provider
+- `/agent-vibes:provider info` - Show current provider
+- `/agent-vibes:provider list` - List all providers
+- `/agent-vibes:provider test` - Test provider
+
+### Language Commands:
+- `/agent-vibes:set-language <lang>` - Set TTS language
+- `/agent-vibes:set-language list` - Show languages
+- `/agent-vibes:set-language english` - Reset to English
+
+### Personality Commands:
+- `/agent-vibes:personality <name>` - Set personality
+- `/agent-vibes:personality list` - Show all
+- `/agent-vibes:personality add <name>` - Create custom
+- `/agent-vibes:personality edit <name>` - Edit file
+- `/agent-vibes:personality get` - Show current
+- `/agent-vibes:personality reset` - Reset to normal
+
+### Sentiment Commands:
+- `/agent-vibes:sentiment <name>` - Apply sentiment
+- `/agent-vibes:sentiment list` - Show all
+- `/agent-vibes:sentiment get` - Show current
+- `/agent-vibes:sentiment clear` - Remove sentiment
+
+### BMAD Plugin Commands:
+- `/agent-vibes-bmad status` - Show plugin status
+- `/agent-vibes-bmad enable` - Enable plugin
+- `/agent-vibes-bmad disable` - Disable plugin
+- `/agent-vibes-bmad list` - List agent mappings
+- `/agent-vibes-bmad set <agent> <voice> [personality]` - Update mapping
+- `/agent-vibes-bmad edit` - Edit configuration
+
+### System Commands:
+- `/agent-vibes:version` - Show version
+- `/agent-vibes:update [--yes]` - Update to latest
+
+---
+
+## 🔄 Migration Guide
+
+### From v1.x to v2.0:
+
+**No breaking changes!** v2.0 is fully backward compatible.
+
+**Recommended steps:**
+
+1. **Update AgentVibes:**
+   ```bash
+   /agent-vibes:update
+   ```
+
+2. **Choose your provider:**
+   - If you have ElevenLabs API key → Keep using ElevenLabs
+   - Want free/offline → Switch to Piper TTS:
+     ```bash
+     /agent-vibes:provider switch
+     ```
+
+3. **Try multilingual:**
+   ```bash
+   /agent-vibes:set-language spanish
+   ```
+
+4. **Explore sentiments:**
+   ```bash
+   /agent-vibes:sentiment sarcastic
+   ```
+
+**Your existing settings are preserved:**
+- ✅ Current voice
+- ✅ Personality preferences
+- ✅ Custom voices
+- ✅ BMAD mappings
+
+---
+
+## 💰 Pricing & Cost Management
+
+### ElevenLabs Pricing (2025):
+- **Free:** $0/month - 10,000 chars (light use)
+- **Starter:** $5/month - 30,000 chars (casual)
+- **Creator:** $22/month - 100,000 chars (regular)
+- **Pro:** $99/month - 500,000 chars (heavy)
+
+### Piper TTS:
+- **Completely FREE** - No limits, no API key
+- Offline processing
+- Privacy-focused
+- Great for development and testing
+
+### Cost-Saving Tips:
+1. Use Piper TTS for development
+2. Use ElevenLabs for demos/production
+3. Switch providers with one command:
+   ```bash
+   /agent-vibes:provider switch
+   ```
+
+---
+
+## 🐛 Bug Fixes
+
+- Fixed symlink support for shared hooks
+- Fixed WSL audio static with silence padding
+- Fixed installer directory detection for npx
+- Fixed release notes display in installer
+- Enhanced provider detection and fallback
+- Improved error handling for missing API keys
+- Better voice compatibility checking
+
+---
+
+## 📊 Statistics
+
+**v2.0.0 by the numbers:**
+- 🎤 **200+ voices** across both providers
+- 🌍 **30+ languages** supported
+- 🎭 **19 personalities** included
+- 💭 **19 sentiments** available
+- 📝 **15 slash commands** total
+- 🔧 **12 hook scripts** installed
+- 🔌 **2 TTS providers** available
+- 🤖 **10 BMAD agents** with voice mapping
+
+---
+
+## 🙏 Credits
+
+**Built with ❤️ by [Paul Preibisch](https://github.com/paulpreibisch)**
+
+**Powered by:**
+- [ElevenLabs](https://elevenlabs.io/) - Premium AI voices
+- [Piper TTS](https://github.com/rhasspy/piper) - Free neural voices
+- [Claude Code](https://claude.com/claude-code) - AI coding assistant
+
+**Special Thanks:**
+- [@disler](https://github.com/disler) for Claude Code hooks inspiration
+- ElevenLabs team for incredible voice technology
+- Piper TTS community for open-source excellence
+- BMAD community for multi-agent framework
+
+---
+
+## 🚀 Get Started
+
+### Install v2.0:
+```bash
+npx agentvibes install
+```
+
+### Update from v1.x:
+```bash
+/agent-vibes:update
+```
+
+### Enable Voice in Claude Code:
+```bash
+/output-style agent-vibes
+```
+
+---
+
+## 📚 Resources
+
+- 📖 **Documentation:** [README.md](README.md)
+- 🐛 **Issues:** [GitHub Issues](https://github.com/paulpreibisch/AgentVibes/issues)
+- 💬 **Discussions:** [GitHub Discussions](https://github.com/paulpreibisch/AgentVibes/discussions)
+- 🌐 **Website:** [agentvibes.org](https://agentvibes.org)
+- 📦 **NPM:** [npmjs.com/package/agentvibes](https://www.npmjs.com/package/agentvibes)
+
+---
+
+**Ready to code with personality in multiple languages? Install v2.0 now! 🎤✨**
+
+[↑ Back to top](#-agentvibes-v200---the-multi-provider-revolution)

package/package.json

@@ -1,8 +1,9 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "1.1.3",
-  "description": "Beautiful ElevenLabs TTS voice commands for Claude Code - Add professional narration to your AI coding sessions",
+  "version": "2.0.1",
+  "description": "Bring your Claude Code sessions to life with voice! Professional TTS narration with multi-provider support.",
+  "homepage": "https://agentvibes.org",
   "keywords": [
     "elevenlabs",
     "tts",

package/src/installer.js

@@ -97,12 +97,14 @@ async function install(options = {}) {
   }
 
   console.log(chalk.cyan('\n📦 What will be installed:'));
-  console.log(chalk.gray(`   • 11 slash commands → ${targetDir}/.claude/commands/agent-vibes/`));
-  console.log(chalk.gray(`   • 6 TTS scripts → ${targetDir}/.claude/hooks/`));
-  console.log(chalk.gray(`   • 10+ personality templates → ${targetDir}/.claude/personalities/`));
+  console.log(chalk.gray(`   • 16 slash commands → ${targetDir}/.claude/commands/agent-vibes/`));
+  console.log(chalk.gray(`   • Multi-provider TTS system (ElevenLabs + Piper TTS) → ${targetDir}/.claude/hooks/`));
+  console.log(chalk.gray(`   • 19 personality templates → ${targetDir}/.claude/personalities/`));
   console.log(chalk.gray(`   • Agent Vibes output style → ${targetDir}/.claude/output-styles/`));
-  console.log(chalk.gray(`   • Voice configuration files`));
-  console.log(chalk.gray(`   • 22 unique ElevenLabs voices\n`));
+  console.log(chalk.gray(`   • 27+ curated voices (ElevenLabs premium)`));
+  console.log(chalk.gray(`   • 50+ neural voices (Piper TTS - free & offline)`));
+  console.log(chalk.gray(`   • 30+ language support with native voices`));
+  console.log(chalk.gray(`   • BMAD integration for multi-agent sessions\n`));
 
   // Confirmation prompt (unless --yes flag is used)
   if (!options.yes) {
@@ -199,10 +201,22 @@ async function install(options = {}) {
     // Create personalities directory
     await fs.mkdir(destPersonalitiesDir, { recursive: true });
 
-    // Copy all personality files
+    // Copy all personality files (excluding directories like 'backups')
     const personalityFiles = await fs.readdir(srcPersonalitiesDir);
-    console.log(chalk.cyan(`🎭 Installing ${personalityFiles.length} personality templates:`));
+    const personalityMdFiles = [];
+
     for (const file of personalityFiles) {
+      const srcPath = path.join(srcPersonalitiesDir, file);
+      const stat = await fs.stat(srcPath);
+
+      // Only copy .md files, skip directories
+      if (stat.isFile() && file.endsWith('.md')) {
+        personalityMdFiles.push(file);
+      }
+    }
+
+    console.log(chalk.cyan(`🎭 Installing ${personalityMdFiles.length} personality templates:`));
+    for (const file of personalityMdFiles) {
       const srcPath = path.join(srcPersonalitiesDir, file);
       const destPath = path.join(destPersonalitiesDir, file);
       await fs.copyFile(srcPath, destPath);