agentvibes 1.0.13 → 1.0.15

package/.claude/commands/agent-vibes-bmad.md

@@ -0,0 +1,132 @@
+# /agent-vibes:bmad Command
+
+Manage BMAD voice plugin integration for automatic voice assignment to BMAD agents.
+
+## Usage
+
+```
+/agent-vibes:bmad <subcommand> [arguments]
+```
+
+## Subcommands
+
+### `enable`
+Enables automatic voice assignment for BMAD agents.
+
+**Example:**
+```
+/agent-vibes:bmad enable
+```
+
+**Output:**
+- Creates `.claude/plugins/bmad-voices-enabled.flag`
+- Shows current agent voice mappings
+- Confirms activation
+
+### `disable`
+Disables BMAD voice plugin (reverts to default AgentVibes behavior).
+
+**Example:**
+```
+/agent-vibes:bmad disable
+```
+
+**Output:**
+- Removes activation flag
+- AgentVibes uses default voice settings
+
+### `status`
+Shows plugin status and current voice mappings.
+
+**Example:**
+```
+/agent-vibes:bmad status
+```
+
+**Output:**
+```
+✅ BMAD voice plugin: ENABLED
+
+📊 BMAD Agent Voice Mappings:
+   pm → Matthew Schmitz [professional]
+   dev → Jessica Anne Bogart [normal]
+   qa → Ralf Eisend [professional]
+   ...
+```
+
+### `list`
+Lists all BMAD agents and their assigned voices.
+
+**Example:**
+```
+/agent-vibes:bmad list
+```
+
+### `set <agent-id> <voice> [personality]`
+Quickly change voice for specific agent.
+
+**Examples:**
+```
+/agent-vibes:bmad set pm "Aria"
+/agent-vibes:bmad set dev "Cowboy Bob" sarcastic
+/agent-vibes:bmad set qa "Northern Terry" professional
+```
+
+**Arguments:**
+- `agent-id`: BMAD agent identifier (pm, dev, qa, architect, po, analyst, sm, ux-expert, bmad-master, bmad-orchestrator)
+- `voice`: Valid AgentVibes voice name
+- `personality` (optional): Personality to apply (default: normal)
+
+### `edit`
+Opens `.claude/plugins/bmad-voices.md` for manual editing.
+
+**Example:**
+```
+/agent-vibes:bmad edit
+```
+
+**Usage:**
+Edit the markdown table directly to change voice mappings.
+
+## How It Works
+
+1. **Plugin File**: `.claude/plugins/bmad-voices.md` contains voice mappings
+2. **Activation Flag**: `.claude/plugins/bmad-voices-enabled.flag` enables/disables plugin
+3. **Auto-Detection**: When a BMAD agent activates (e.g., `/BMad:agents:pm`), AgentVibes automatically:
+   - Detects the agent ID from the command
+   - Looks up voice mapping in plugin file
+   - Uses assigned voice for TTS acknowledgments/completions
+
+## Available BMAD Agents
+
+| Agent ID | Role | Default Voice |
+|----------|------|---------------|
+| pm | Product Manager | Matthew Schmitz |
+| dev | Developer | Jessica Anne Bogart |
+| qa | QA Engineer | Ralf Eisend |
+| architect | Architect | Michael |
+| po | Product Owner | Amy |
+| analyst | Analyst | Lutz Laugh |
+| sm | Scrum Master | Ms. Walker |
+| ux-expert | UX Expert | Aria |
+| bmad-master | BMAD Master | Aria |
+| bmad-orchestrator | Orchestrator | Ms. Walker |
+
+## Implementation Details
+
+**For AgentVibes Developers:**
+
+The plugin integrates with the Agent Vibes output style through bash hooks:
+
+```bash
+# Check if BMAD agent is active
+BMAD_AGENT_ID=$(echo "$COMMAND" | grep -oP '/BMad:agents:\K[a-z-]+')
+
+# Get voice from plugin if enabled
+if [[ -n "$BMAD_AGENT_ID" ]]; then
+    MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
+    if [[ -n "$MAPPED_VOICE" ]]; then
+        .claude/hooks/play-tts.sh "message" "$MAPPED_VOICE"
+    fi
+fi
+```

package/.claude/hooks/bmad-voice-manager.sh

@@ -0,0 +1,278 @@
+#!/bin/bash
+
+PLUGIN_DIR=".claude/plugins"
+PLUGIN_FILE="$PLUGIN_DIR/bmad-voices.md"
+ENABLED_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
+
+# Auto-enable plugin if BMAD is detected
+auto_enable_if_bmad_detected() {
+    # Check if BMAD is installed
+    if [[ -f ".bmad-core/install-manifest.yaml" ]] && [[ ! -f "$ENABLED_FLAG" ]]; then
+        # BMAD detected but plugin not enabled - enable it silently
+        mkdir -p "$PLUGIN_DIR"
+        touch "$ENABLED_FLAG"
+        return 0
+    fi
+    return 1
+}
+
+# Parse markdown table to get voice mapping
+get_agent_voice() {
+    local agent_id="$1"
+
+    # Auto-enable if BMAD is detected
+    auto_enable_if_bmad_detected
+
+    if [[ ! -f "$ENABLED_FLAG" ]]; then
+        echo ""  # Plugin disabled
+        return
+    fi
+
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo ""  # Plugin file missing
+        return
+    fi
+
+    # Extract voice from markdown table
+    local voice=$(grep "^| $agent_id " "$PLUGIN_FILE" | \
+                  awk -F'|' '{print $4}' | \
+                  sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+    echo "$voice"
+}
+
+# Get personality for agent
+get_agent_personality() {
+    local agent_id="$1"
+
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo ""
+        return
+    fi
+
+    local personality=$(grep "^| $agent_id " "$PLUGIN_FILE" | \
+                       awk -F'|' '{print $5}' | \
+                       sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+    echo "$personality"
+}
+
+# Check if plugin is enabled
+is_plugin_enabled() {
+    [[ -f "$ENABLED_FLAG" ]] && echo "true" || echo "false"
+}
+
+# Enable plugin
+enable_plugin() {
+    mkdir -p "$PLUGIN_DIR"
+
+    # Save current settings before enabling
+    BACKUP_FILE="$PLUGIN_DIR/.bmad-previous-settings"
+
+    # Save current voice
+    if [[ -f ".claude/tts-voice.txt" ]]; then
+        CURRENT_VOICE=$(cat .claude/tts-voice.txt 2>/dev/null)
+    elif [[ -f "$HOME/.claude/tts-voice.txt" ]]; then
+        CURRENT_VOICE=$(cat "$HOME/.claude/tts-voice.txt" 2>/dev/null)
+    else
+        CURRENT_VOICE="Aria"
+    fi
+
+    # Save current personality
+    if [[ -f ".claude/tts-personality.txt" ]]; then
+        CURRENT_PERSONALITY=$(cat .claude/tts-personality.txt 2>/dev/null)
+    elif [[ -f "$HOME/.claude/tts-personality.txt" ]]; then
+        CURRENT_PERSONALITY=$(cat "$HOME/.claude/tts-personality.txt" 2>/dev/null)
+    else
+        CURRENT_PERSONALITY="normal"
+    fi
+
+    # Save current sentiment
+    if [[ -f ".claude/tts-sentiment.txt" ]]; then
+        CURRENT_SENTIMENT=$(cat .claude/tts-sentiment.txt 2>/dev/null)
+    elif [[ -f "$HOME/.claude/tts-sentiment.txt" ]]; then
+        CURRENT_SENTIMENT=$(cat "$HOME/.claude/tts-sentiment.txt" 2>/dev/null)
+    else
+        CURRENT_SENTIMENT=""
+    fi
+
+    # Write backup
+    cat > "$BACKUP_FILE" <<EOF
+VOICE=$CURRENT_VOICE
+PERSONALITY=$CURRENT_PERSONALITY
+SENTIMENT=$CURRENT_SENTIMENT
+EOF
+
+    touch "$ENABLED_FLAG"
+    echo "✅ BMAD voice plugin enabled"
+    echo "💾 Previous settings backed up:"
+    echo "   Voice: $CURRENT_VOICE"
+    echo "   Personality: $CURRENT_PERSONALITY"
+    [[ -n "$CURRENT_SENTIMENT" ]] && echo "   Sentiment: $CURRENT_SENTIMENT"
+    echo ""
+    list_mappings
+}
+
+# Disable plugin
+disable_plugin() {
+    BACKUP_FILE="$PLUGIN_DIR/.bmad-previous-settings"
+
+    # Check if we have a backup to restore
+    if [[ -f "$BACKUP_FILE" ]]; then
+        source "$BACKUP_FILE"
+
+        echo "❌ BMAD voice plugin disabled"
+        echo "🔄 Restoring previous settings:"
+        echo "   Voice: $VOICE"
+        echo "   Personality: $PERSONALITY"
+        [[ -n "$SENTIMENT" ]] && echo "   Sentiment: $SENTIMENT"
+
+        # Restore voice
+        if [[ -n "$VOICE" ]]; then
+            echo "$VOICE" > .claude/tts-voice.txt 2>/dev/null || echo "$VOICE" > "$HOME/.claude/tts-voice.txt"
+        fi
+
+        # Restore personality
+        if [[ -n "$PERSONALITY" ]] && [[ "$PERSONALITY" != "normal" ]]; then
+            echo "$PERSONALITY" > .claude/tts-personality.txt 2>/dev/null || echo "$PERSONALITY" > "$HOME/.claude/tts-personality.txt"
+        fi
+
+        # Restore sentiment
+        if [[ -n "$SENTIMENT" ]]; then
+            echo "$SENTIMENT" > .claude/tts-sentiment.txt 2>/dev/null || echo "$SENTIMENT" > "$HOME/.claude/tts-sentiment.txt"
+        fi
+
+        # Clean up backup
+        rm -f "$BACKUP_FILE"
+    else
+        echo "❌ BMAD voice plugin disabled"
+        echo "⚠️  No previous settings found to restore"
+        echo "AgentVibes will use current voice/personality settings"
+    fi
+
+    rm -f "$ENABLED_FLAG"
+}
+
+# List all mappings
+list_mappings() {
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo "❌ Plugin file not found: $PLUGIN_FILE"
+        return 1
+    fi
+
+    echo "📊 BMAD Agent Voice Mappings:"
+    echo ""
+
+    grep "^| " "$PLUGIN_FILE" | grep -v "Agent ID" | grep -v "^|---" | \
+    while IFS='|' read -r _ agent_id name voice personality _; do
+        agent_id=$(echo "$agent_id" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+        name=$(echo "$name" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+        voice=$(echo "$voice" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+        personality=$(echo "$personality" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+        [[ -n "$agent_id" ]] && echo "   $agent_id → $voice [$personality]"
+    done
+}
+
+# Set voice for agent
+set_agent_voice() {
+    local agent_id="$1"
+    local voice="$2"
+    local personality="${3:-normal}"
+
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo "❌ Plugin file not found: $PLUGIN_FILE"
+        return 1
+    fi
+
+    # Check if agent exists
+    if ! grep -q "^| $agent_id " "$PLUGIN_FILE"; then
+        echo "❌ Agent '$agent_id' not found in plugin"
+        return 1
+    fi
+
+    # Update the voice and personality in the table
+    sed -i.bak "s/^| $agent_id |.*| .* | .* |$/| $agent_id | $(grep "^| $agent_id " "$PLUGIN_FILE" | awk -F'|' '{print $3}') | $voice | $personality |/" "$PLUGIN_FILE"
+
+    echo "✅ Updated $agent_id → $voice [$personality]"
+}
+
+# Show status
+show_status() {
+    # Check for BMAD installation
+    local bmad_installed="false"
+    if [[ -f ".bmad-core/install-manifest.yaml" ]]; then
+        bmad_installed="true"
+    fi
+
+    if [[ $(is_plugin_enabled) == "true" ]]; then
+        echo "✅ BMAD voice plugin: ENABLED"
+        if [[ "$bmad_installed" == "true" ]]; then
+            echo "🔍 BMAD detected: Auto-enabled"
+        fi
+    else
+        echo "❌ BMAD voice plugin: DISABLED"
+        if [[ "$bmad_installed" == "true" ]]; then
+            echo "⚠️  BMAD detected but plugin disabled (enable with: /agent-vibes-bmad enable)"
+        fi
+    fi
+    echo ""
+    list_mappings
+}
+
+# Edit plugin file
+edit_plugin() {
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo "❌ Plugin file not found: $PLUGIN_FILE"
+        return 1
+    fi
+
+    echo "Opening $PLUGIN_FILE for editing..."
+    echo "Edit the markdown table to change voice mappings"
+}
+
+# Main command dispatcher
+case "${1:-help}" in
+    enable)
+        enable_plugin
+        ;;
+    disable)
+        disable_plugin
+        ;;
+    status)
+        show_status
+        ;;
+    list)
+        list_mappings
+        ;;
+    set)
+        if [[ -z "$2" ]] || [[ -z "$3" ]]; then
+            echo "Usage: bmad-voice-manager.sh set <agent-id> <voice> [personality]"
+            exit 1
+        fi
+        set_agent_voice "$2" "$3" "$4"
+        ;;
+    get-voice)
+        get_agent_voice "$2"
+        ;;
+    get-personality)
+        get_agent_personality "$2"
+        ;;
+    edit)
+        edit_plugin
+        ;;
+    *)
+        echo "Usage: bmad-voice-manager.sh {enable|disable|status|list|set|get-voice|get-personality|edit}"
+        echo ""
+        echo "Commands:"
+        echo "  enable              Enable BMAD voice plugin"
+        echo "  disable             Disable BMAD voice plugin"
+        echo "  status              Show plugin status and mappings"
+        echo "  list                List all agent voice mappings"
+        echo "  set <id> <voice>    Set voice for agent"
+        echo "  get-voice <id>      Get voice for agent"
+        echo "  get-personality <id> Get personality for agent"
+        echo "  edit                Edit plugin configuration"
+        exit 1
+        ;;
+esac

package/.claude/hooks/voices-config.sh

@@ -4,7 +4,9 @@
 
 declare -A VOICES=(
   ["Amy"]="bhJUNIXWQQ94l8eI2VUf"
+  ["Archer"]="L0Dsvb3SLTyegXwtm47J"
   ["Aria"]="TC0Zp7WVFzhA8zpTlRqV"
+  ["Burt Reynolds"]="4YYIPFl9wE5c4L2eu2Gb"
   ["Cowboy Bob"]="KTPVrSVAEUSJRClDzBw7"
   ["Demon Monster"]="vfaqCOvlrKi4Zp7C2IAm"
   ["Dr. Von Fusion"]="yjJ45q8TVCrtMhEKurxY"
@@ -12,6 +14,7 @@ declare -A VOICES=(
   ["Grandpa Spuds Oxley"]="NOpBlnGInO9m6vDvFkFC"
   ["Grandpa Werthers"]="MKlLqCItoCkvdhrxgtLv"
   ["Jessica Anne Bogart"]="flHkNRp1BlvT73UL6gyz"
+  ["Juniper"]="aMSt68OGf4xUZAnLpTU8"
   ["Lutz Laugh"]="9yzdeviXkFddZ4Oz8Mok"
   ["Matthew Schmitz"]="0SpgpJ4D3MpHCiWdyTg3"
   ["Michael"]="U1Vk2oyatMdYs096Ety7"
@@ -19,4 +22,6 @@ declare -A VOICES=(
   ["Northern Terry"]="wo6udizrrtpIxWGp2qJk"
   ["Pirate Marshal"]="PPzYpIqttlTYA83688JI"
   ["Ralf Eisend"]="A9evEp8yGjv4c3WsIKuY"
+  ["Tiffany"]="6aDn1KB0hjpdcocrUkmq"
+  ["Tom"]="DYkrAHD8iwork3YSUBbs"
 )

package/.claude/output-styles/agent-vibes.md

@@ -115,6 +115,64 @@ You: "✅ That bug be walkin' the plank now, arr!"
 [Bash: .claude/hooks/play-tts.sh "That bug be walkin' the plank now, arr!"]
 ```
 
+## BMAD Plugin Integration
+
+**Automatic voice switching for BMAD agents:**
+
+When a BMAD agent is activated (e.g., `/BMad:agents:pm`), AgentVibes will automatically:
+
+1. **Detect BMAD agent from command/context**
+2. **Check if BMAD plugin is enabled** (`.claude/plugins/bmad-voices-enabled.flag`)
+3. **Look up voice mapping** from `.claude/plugins/bmad-voices.md`
+4. **Apply agent's assigned voice** for all TTS acknowledgments/completions
+5. **Apply agent's personality** from the mapping (if specified)
+
+**Implementation:**
+```bash
+# At the start of acknowledgment/completion:
+# Try to detect BMAD agent ID from current context
+BMAD_AGENT_ID=""
+
+# Method 1: Check if we're in a BMAD agent command context
+if [[ -f ".bmad-agent-context" ]]; then
+    BMAD_AGENT_ID=$(cat .bmad-agent-context 2>/dev/null)
+fi
+
+# Method 2: Parse from command history/context (fallback)
+# Note: This detection happens automatically when BMAD agent activates
+
+# If BMAD agent detected and plugin enabled, use mapped voice
+if [[ -n "$BMAD_AGENT_ID" ]] && [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
+    MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
+    MAPPED_PERSONALITY=$(.claude/hooks/bmad-voice-manager.sh get-personality "$BMAD_AGENT_ID")
+
+    if [[ -n "$MAPPED_VOICE" ]]; then
+        # Use BMAD agent's mapped voice and personality
+        if [[ -n "$MAPPED_PERSONALITY" ]] && [[ "$MAPPED_PERSONALITY" != "normal" ]]; then
+            # Read personality instructions from .claude/personalities/${MAPPED_PERSONALITY}.md
+            # Generate response in that personality style
+        fi
+        .claude/hooks/play-tts.sh "message" "$MAPPED_VOICE"
+        # Exit early - don't use default personality system
+        return
+    fi
+fi
+
+# If no BMAD agent or plugin disabled, use standard personality/sentiment system
+# ... continue with normal sentiment/personality logic ...
+```
+
+**BMAD Agent Context Tracking:**
+- When a BMAD agent activates, write agent ID to `.bmad-agent-context`
+- When agent exits, remove the file
+- This allows AgentVibes to know which BMAD agent is active
+
+**Voice Priority (in order):**
+1. BMAD plugin voice (if agent active and plugin enabled)
+2. Sentiment mode (if set)
+3. Personality mode (if set)
+4. Default voice
+
 ## Critical Rules
 
 1. **ALWAYS use Bash tool** to execute play-tts.sh

package/.claude/personalities/grandpa.md

@@ -1,7 +1,7 @@
 ---
 name: grandpa
 description: Rambling nostalgic storyteller
-voice: Grandpa Werthers
+voice: Grandpa Spuds Oxley
 ---
 
 # Grandpa Personality

package/.claude/plugins/bmad-voices.md

@@ -0,0 +1,42 @@
+---
+plugin: bmad-voices
+version: 1.0.0
+enabled: true
+description: Voice mappings for BMAD agents
+---
+
+# BMAD Voice Plugin
+
+This plugin automatically assigns voices to BMAD agents based on their role.
+
+## Agent Voice Mappings
+
+| Agent ID | Agent Name | Voice | Personality |
+|----------|------------|-------|-------------|
+| pm | John (Product Manager) | Jessica Anne Bogart | professional |
+| dev | James (Developer) | Matthew Schmitz | normal |
+| qa | Quinn (QA) | Burt Reynolds | professional |
+| architect | Winston (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 |
+
+## How to Edit
+
+Simply edit the table above to change voice mappings. The format is:
+- **Agent ID**: Must match BMAD's `agent.id` field
+- **Agent Name**: Display name (for reference only)
+- **Voice**: Must be a valid AgentVibes voice name
+- **Personality**: Optional personality to apply (or "normal" for none)
+
+## Commands
+
+- `/agent-vibes:bmad enable` - Enable BMAD voice plugin
+- `/agent-vibes:bmad disable` - Disable BMAD voice plugin
+- `/agent-vibes:bmad status` - Show plugin status
+- `/agent-vibes:bmad edit` - Open this file for editing
+- `/agent-vibes:bmad list` - List all agent voice mappings
+- `/agent-vibes:bmad set <agent-id> <voice> [personality]` - Set voice for specific agent

package/README.md

@@ -13,9 +13,36 @@
 
 ---
 
+## 📑 Table of Contents
+
+### Getting Started
+- [🚀 Quick Start](#-quick-start) - Install in 3 steps
+- [✨ What is AgentVibes?](#-what-is-agentvibes) - Overview & key features
+- [📰 Latest Release](#-latest-release) - What's new
+
+### Core Features
+- [🎤 Commands Reference](#-commands-reference) - All available commands
+- [🎭 Personalities vs Sentiments](#-personalities-vs-sentiments) - Two systems explained
+- [🗣️ Voice Library](#️-voice-library) - 17+ professional voices
+- [🔌 BMAD Plugin](#-bmad-plugin) - Auto voice switching for BMAD agents
+
+### Advanced Topics
+- [📦 Installation Structure](#-installation-structure) - What gets installed
+- [💡 Usage Examples](#-usage-examples) - Common workflows
+- [🔧 Advanced Features](#-advanced-features) - Custom voices & personalities
+- [💰 Pricing & Usage](#-pricing--usage) - ElevenLabs costs & monitoring
+- [❓ Troubleshooting](#-troubleshooting) - Common issues & fixes
+
+### Additional Resources
+- [🔄 Updating](#-updating) - Keep AgentVibes current
+- [🙏 Credits](#-credits) - Acknowledgments
+- [🤝 Contributing](#-contributing) - Show support
+
+---
+
 ## 📰 Latest Release
 
-**[v1.0.13 - Detailed Release Notes](https://github.com/paulpreibisch/AgentVibes/releases/tag/v1.0.13)** 🐛
+**[v1.0.13 - Release Notes](https://github.com/paulpreibisch/AgentVibes/releases/tag/v1.0.13)** 🐛
 
 Critical bug fixes for update command and personality system, plus new dry humor personality and comprehensive voice mapping tests.
 
@@ -34,11 +61,14 @@ Imagine Claude speaking to you with different voices and personalities as you co
 - 🎙️ **17+ 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
 - ⚡ **One-Command Install** - Get started in seconds
 
+[↑ Back to top](#-table-of-contents)
+
 ---
 
 ## 🚀 Quick Start
@@ -89,9 +119,11 @@ source ~/.bashrc
 
 **That's it! Claude will now speak to you!** 🎉
 
+[↑ Back to top](#-table-of-contents)
+
 ---
 
-## 🎤 Available Commands
+## 🎤 Commands Reference
 
 All commands are prefixed with `/agent-vibes:`
 
@@ -128,11 +160,18 @@ All commands are prefixed with `/agent-vibes:`
 | `/agent-vibes:sentiment get` | Show current sentiment |
 | `/agent-vibes:sentiment clear` | Remove sentiment |
 
-### Advanced Commands
+### BMAD Plugin Commands
 
 | Command | Description |
 |---------|-------------|
-| `/agent-vibes:set-pretext <text>` | Add prefix to all TTS messages |
+| `/agent-vibes-bmad status` | Show BMAD plugin status & mappings |
+| `/agent-vibes-bmad enable` | Enable automatic voice switching |
+| `/agent-vibes-bmad disable` | Disable plugin (restores previous settings) |
+| `/agent-vibes-bmad list` | List all BMAD agent voice mappings |
+| `/agent-vibes-bmad set <agent> <voice> [personality]` | Update agent mapping |
+| `/agent-vibes-bmad edit` | Edit configuration file |
+
+[↑ Back to top](#-table-of-contents)
 
 ---
 
@@ -147,13 +186,14 @@ All commands are prefixed with `/agent-vibes:`
 | **sarcastic** | Jessica Anne Bogart | Dry wit and cutting observations |
 | **flirty** | Jessica Anne Bogart | Playful charm and compliments |
 | **pirate** | Pirate Marshal | Seafaring swagger - "Arr matey!" |
-| **grandpa** | Grandpa Werthers | Rambling nostalgic stories |
-| **angry** | Drill Sergeant | Frustrated and loud |
+| **grandpa** | Grandpa Spuds Oxley | Rambling nostalgic stories |
+| **dry-humor** | Aria | British wit and deadpan delivery |
+| **angry** | Demon Monster | Frustrated and loud |
 | **robot** | Dr. Von Fusion | Mechanical and precise |
 | **zen** | Aria | Peaceful and mindful |
-| **professional** | Michael | Formal and corporate |
+| **professional** | Matthew Schmitz | Formal and corporate |
 
-**All 18 personalities:** sarcastic, flirty, pirate, grandpa, angry, robot, zen, professional, dramatic, millennial, surfer-dude, sassy, poetic, moody, funny, annoying, crass, normal, random
+**All 19 personalities:** sarcastic, flirty, pirate, grandpa, dry-humor, angry, robot, zen, professional, dramatic, millennial, surfer-dude, sassy, poetic, moody, funny, annoying, crass, normal, random
 
 ```bash
 /agent-vibes:personality sarcastic
@@ -184,64 +224,114 @@ All commands are prefixed with `/agent-vibes:`
 /agent-vibes:switch Aria --sentiment sarcastic
 ```
 
+[↑ Back to top](#-table-of-contents)
+
+---
+
+## 🗣️ Voice Library
+
+AgentVibes includes **22 unique ElevenLabs voices:**
+
+| Voice | Character | Best For |
+|-------|-----------|----------|
+| [Aria](https://elevenlabs.io/voice-library/aria-professional-narration/TC0Zp7WVFzhA8zpTlRqV) | Clear professional | Default, all-purpose |
+| [Archer](https://elevenlabs.io/voice-library/archer/L0Dsvb3SLTyegXwtm47J) | Authoritative, commanding | Leadership, orchestration |
+| [Jessica Anne Bogart](https://elevenlabs.io/voice-library/jessica-anne-bogart/flHkNRp1BlvT73UL6gyz) | Wickedly eloquent | Sarcastic, flirty |
+| [Pirate Marshal](https://elevenlabs.io/voice-library/pirate-marshal/PPzYpIqttlTYA83688JI) | Authentic pirate | Pirate personality |
+| [Grandpa Spuds Oxley](https://elevenlabs.io/voice-library/grandpa-spuds-oxley/NOpBlnGInO9m6vDvFkFC) | Wise elder | Grandpa personality |
+| [Matthew Schmitz](https://elevenlabs.io/voice-library/matthew-schmitz/0SpgpJ4D3MpHCiWdyTg3) | Deep baritone | Professional |
+| [Cowboy Bob](https://elevenlabs.io/voice-library/cowboy-bob/KTPVrSVAEUSJRClDzBw7) | Western charm | Casual, friendly |
+| [Northern Terry](https://elevenlabs.io/voice-library/northern-terry/wo6udizrrtpIxWGp2qJk) | Eccentric British | Quirky responses |
+| [Ms. Walker](https://elevenlabs.io/voice-library/ms-walker/DLsHlh26Ugcm6ELvS0qi) | Warm teacher | Professional |
+| [Dr. Von Fusion](https://elevenlabs.io/voice-library/dr-von-fusion/yjJ45q8TVCrtMhEKurxY) | Mad scientist | Robot personality |
+| [Michael](https://elevenlabs.io/voice-library/michael/U1Vk2oyatMdYs096Ety7) | British urban | Professional |
+| [Ralf Eisend](https://elevenlabs.io/voice-library/ralf-eisend/A9evEp8yGjv4c3WsIKuY) | International | Multi-cultural |
+| [Amy](https://elevenlabs.io/voice-library/amy/bhJUNIXWQQ94l8eI2VUf) | Chinese accent | Diverse |
+| [Lutz Laugh](https://elevenlabs.io/voice-library/lutz-laugh/9yzdeviXkFddZ4Oz8Mok) | Jovial | Funny |
+| [Burt Reynolds](https://elevenlabs.io/voice-library/burt-reynolds/4YYIPFl9wE5c4L2eu2Gb) | Smooth baritone | Confident, charismatic |
+| [Juniper](https://elevenlabs.io/voice-library/juniper/aMSt68OGf4xUZAnLpTU8) | Warm, friendly | Stakeholder relations |
+| [Tiffany](https://elevenlabs.io/voice-library/tiffany/6aDn1KB0hjpdcocrUkmq) | Professional, clear | Product ownership, leadership |
+| [Tom](https://elevenlabs.io/voice-library/tom/DYkrAHD8iwork3YSUBbs) | Professional, organized | Orchestration, coordination |
+| [Demon Monster](https://elevenlabs.io/voice-library/demon-monster/vfaqCOvlrKi4Zp7C2IAm) | Deep and spooky | Dramatic |
+
+💡 **Tip:** Click voice names to hear samples on ElevenLabs!
+
+[↑ Back to top](#-table-of-contents)
+
 ---
 
-## 🗣️ Available Voices
-
-AgentVibes includes **17 unique ElevenLabs voices:**
-
-| Voice | Character | Best For | Listen |
-|-------|-----------|----------|--------|
-| [Aria](https://elevenlabs.io/voice-library/aria-professional-narration/TC0Zp7WVFzhA8zpTlRqV) | Clear professional | Default, all-purpose | [Preview](https://elevenlabs.io/voice-library/aria-professional-narration/TC0Zp7WVFzhA8zpTlRqV) |
-| [Jessica Anne Bogart](https://elevenlabs.io/voice-library/jessica-anne-bogart/flHkNRp1BlvT73UL6gyz) | Wickedly eloquent | Sarcastic, flirty | [Preview](https://elevenlabs.io/voice-library/jessica-anne-bogart/flHkNRp1BlvT73UL6gyz) |
-| [Pirate Marshal](https://elevenlabs.io/voice-library/pirate-marshal/PPzYpIqttlTYA83688JI) | Authentic pirate | Pirate personality | [Preview](https://elevenlabs.io/voice-library/pirate-marshal/PPzYpIqttlTYA83688JI) |
-| [Grandpa Werthers](https://elevenlabs.io/voice-library/grandpa-werthers/MKlLqCItoCkvdhrxgtLv) | Nostalgic elder | Grandpa personality | [Preview](https://elevenlabs.io/voice-library/grandpa-werthers/MKlLqCItoCkvdhrxgtLv) |
-| [Drill Sergeant](https://elevenlabs.io/voice-library/drill-sergeant/vfaqCOvlrKi4Zp7C2IAm) | Military authority | Angry personality | [Preview](https://elevenlabs.io/voice-library/drill-sergeant/vfaqCOvlrKi4Zp7C2IAm) |
-| [Cowboy Bob](https://elevenlabs.io/voice-library/cowboy-bob/KTPVrSVAEUSJRClDzBw7) | Western charm | Casual, friendly | [Preview](https://elevenlabs.io/voice-library/cowboy-bob/KTPVrSVAEUSJRClDzBw7) |
-| [Northern Terry](https://elevenlabs.io/voice-library/northern-terry/wo6udizrrtpIxWGp2qJk) | Eccentric British | Quirky responses | [Preview](https://elevenlabs.io/voice-library/northern-terry/wo6udizrrtpIxWGp2qJk) |
-| [Ms. Walker](https://elevenlabs.io/voice-library/ms-walker/DLsHlh26Ugcm6ELvS0qi) | Warm teacher | Professional | [Preview](https://elevenlabs.io/voice-library/ms-walker/DLsHlh26Ugcm6ELvS0qi) |
-| [Dr. Von Fusion](https://elevenlabs.io/voice-library/dr-von-fusion/yjJ45q8TVCrtMhEKurxY) | Mad scientist | Robot personality | [Preview](https://elevenlabs.io/voice-library/dr-von-fusion/yjJ45q8TVCrtMhEKurxY) |
-| [Matthew Schmitz](https://elevenlabs.io/voice-library/matthew-schmitz/0SpgpJ4D3MpHCiWdyTg3) | Deep baritone | Dramatic | [Preview](https://elevenlabs.io/voice-library/matthew-schmitz/0SpgpJ4D3MpHCiWdyTg3) |
-| [Grandpa Spuds Oxley](https://elevenlabs.io/voice-library/grandpa-spuds-oxley/NOpBlnGInO9m6vDvFkFC) | Wise elder | Wisdom | [Preview](https://elevenlabs.io/voice-library/grandpa-spuds-oxley/NOpBlnGInO9m6vDvFkFC) |
-| [Michael](https://elevenlabs.io/voice-library/michael/U1Vk2oyatMdYs096Ety7) | British urban | Professional | [Preview](https://elevenlabs.io/voice-library/michael/U1Vk2oyatMdYs096Ety7) |
-| [Ralf Eisend](https://elevenlabs.io/voice-library/ralf-eisend/A9evEp8yGjv4c3WsIKuY) | International | Multi-cultural | [Preview](https://elevenlabs.io/voice-library/ralf-eisend/A9evEp8yGjv4c3WsIKuY) |
-| [Amy](https://elevenlabs.io/voice-library/amy/bhJUNIXWQQ94l8eI2VUf) | Chinese accent | Diverse | [Preview](https://elevenlabs.io/voice-library/amy/bhJUNIXWQQ94l8eI2VUf) |
-| [Lutz Laugh](https://elevenlabs.io/voice-library/lutz-laugh/9yzdeviXkFddZ4Oz8Mok) | Jovial | Funny | [Preview](https://elevenlabs.io/voice-library/lutz-laugh/9yzdeviXkFddZ4Oz8Mok) |
-| [Demon Monster](https://elevenlabs.io/voice-library/demon-monster/vfaqCOvlrKi4Zp7C2IAm) | Deep and spooky | Dramatic | [Preview](https://elevenlabs.io/voice-library/demon-monster/vfaqCOvlrKi4Zp7C2IAm) |
-
-**💡 Tip:** Click voice names or Preview links to hear samples on ElevenLabs before choosing!
+## 🔌 BMAD Plugin
+
+**Automatically switch voices when using BMAD agents!**
+
+The BMAD plugin detects when you activate a BMAD agent (e.g., `/BMad:agents:pm`) and automatically uses the assigned voice for that role.
+
+### 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 |
+
+### Plugin Management
+
+```bash
+# Check status (auto-enables if BMAD detected)
+/agent-vibes-bmad status
+
+# Disable plugin
+/agent-vibes-bmad disable
+
+# Re-enable plugin
+/agent-vibes-bmad enable
+
+# Customize agent voice
+/agent-vibes-bmad set pm "Aria" zen
+
+# Edit configuration
+/agent-vibes-bmad edit
+```
+
+### How It Works
+
+1. **Auto-Detection**: Plugin checks for `.bmad-core/install-manifest.yaml`
+2. **Auto-Enable**: Enables automatically when BMAD is detected
+3. **Settings Preservation**: Saves your previous voice/personality when enabling
+4. **Restore on Disable**: Restores previous settings when disabling
+
+[↑ Back to top](#-table-of-contents)
 
 ---
 
-## 📦 What Gets Installed?
+## 📦 Installation Structure
 
 ```
 your-project/
 └── .claude/
     ├── commands/
-    │   └── agent-vibes/              # All slash commands
-    │       ├── agent-vibes.md
-    │       ├── agent-vibes:list.md
-    │       ├── agent-vibes:switch.md
-    │       ├── agent-vibes:whoami.md
-    │       ├── agent-vibes:personality.md
-    │       ├── agent-vibes:sentiment.md
-    │       └── ... (12 total)
+    │   ├── agent-vibes/              # Voice commands
+    │   └── agent-vibes-bmad.md       # BMAD plugin command
     ├── hooks/
     │   ├── 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/               # 18 personality templates
-    │   ├── sarcastic.md
-    │   ├── flirty.md
-    │   ├── pirate.md
-    │   └── ... (15 more)
+    ├── personalities/               # 19 personality templates
+    ├── plugins/
+    │   └── bmad-voices.md           # BMAD voice mappings
     ├── output-styles/
     │   └── agent-vibes.md           # Voice output style
     └── audio/                       # Generated TTS files
-        └── tts-*.mp3               # Last 10 kept
 ```
 
 ### Voice Settings Storage
@@ -252,20 +342,7 @@ your-project/
 
 Settings persist across Claude Code sessions!
 
----
-
-## 🔧 CLI Management
-
-```bash
-# Check installation status
-node ~/claude/AgentVibes/bin/agent-vibes status
-
-# Update to latest version
-node ~/claude/AgentVibes/bin/agent-vibes update
-
-# Install with options
-node ~/claude/AgentVibes/bin/agent-vibes install --yes --directory ~/my-project
-```
+[↑ Back to top](#-table-of-contents)
 
 ---
 
@@ -285,8 +362,8 @@ node ~/claude/AgentVibes/bin/agent-vibes install --yes --directory ~/my-project
 ```bash
 /agent-vibes:personality sarcastic   # Sarcastic + Jessica Anne Bogart
 /agent-vibes:personality pirate      # Pirate + Pirate Marshal
-/agent-vibes:personality grandpa     # Grandpa + Grandpa Werthers
-/agent-vibes:personality list        # See all 18 personalities
+/agent-vibes:personality dry-humor   # British wit + Aria
+/agent-vibes:personality list        # See all 19 personalities
 ```
 
 ### Use Sentiments
@@ -312,50 +389,11 @@ node ~/claude/AgentVibes/bin/agent-vibes install --yes --directory ~/my-project
 /agent-vibes:preview last 5          # Hear last 5
 ```
 
----
-
-## 🌟 Best Voice/Personality Combos
-
-- **Debugging**: Sarcastic + Jessica Anne Bogart 😏
-- **Learning**: Professional + Michael 📚
-- **Fun Coding**: Pirate + Pirate Marshal 🏴‍☠️
-- **Late Night**: Zen + Aria 🧘
-- **Pair Programming**: Grandpa + Grandpa Werthers 👴
+[↑ Back to top](#-table-of-contents)
 
 ---
 
-## ❓ Troubleshooting
-
-### No Audio Playing?
-
-1. Check API key: `echo $ELEVENLABS_API_KEY`
-2. Check output style: `/output-style agent-vibes`
-3. Test playback: `/agent-vibes:sample Aria`
-
-### Commands Not Found?
-
-```bash
-# Verify installation
-node ~/claude/AgentVibes/bin/agent-vibes status
-
-# Reinstall
-node ~/claude/AgentVibes/bin/agent-vibes install --yes
-```
-
-### Wrong Voice Playing?
-
-```bash
-# Check current setup
-/agent-vibes:whoami
-
-# Reset if needed
-/agent-vibes:personality reset
-/agent-vibes:sentiment clear
-```
-
----
-
-## 🔧 Advanced Usage
+## 🔧 Advanced Features
 
 ### Custom Personalities
 
@@ -388,7 +426,7 @@ node ~/claude/AgentVibes/bin/agent-vibes install --yes
 /agent-vibes:add "My Voice" abc123xyz789
 ```
 
-### Use in Output Styles
+### Use in Custom Output Styles
 
 ```markdown
 I'll do the task
@@ -400,133 +438,118 @@ I'll do the task
 [Bash: .claude/hooks/play-tts.sh "Complete" "Cowboy Bob"]
 ```
 
+[↑ Back to top](#-table-of-contents)
+
 ---
 
-## 🔄 Updating AgentVibes
+## 💰 Pricing & Usage
 
-### If installed via npx:
-```bash
-npx agentvibes update --yes
-```
+### ElevenLabs Pricing (2025)
 
-### If installed globally via npm:
-```bash
-npm update -g agentvibes
-agentvibes update --yes
-```
+| Plan | Monthly Cost | Characters/Month | Best For |
+|------|-------------|------------------|----------|
+| **Free** | $0 | 10,000 | Trying it out, light use |
+| **Starter** | $5 | 30,000 | Casual coding (1-2 hrs/day) |
+| **Creator** | $22 | 100,000 | Regular coding (4-5 hrs/day) |
+| **Pro** | $99 | 500,000 | Heavy daily use (8+ hrs/day) |
+| **Scale** | $330 | 2,000,000 | Professional/teams |
 
-### If installed from source:
-```bash
-cd ~/AgentVibes
-git pull origin master
-npm install
-node bin/agent-vibes update --yes
-```
+### Monitor Your Usage
 
-The update command will:
-- ✅ Update all slash commands
-- ✅ Update TTS scripts
-- ✅ Add new personalities (keeps your custom ones)
-- ✅ Update output styles
-- ⚠️  Preserves your voice settings and configurations
+**Track consumption in real-time:**
 
----
+1. **Go to ElevenLabs Dashboard**: https://elevenlabs.io/app/usage
+2. **Monitor**: Credits used, character breakdown, billing period
+3. **Set alerts**: Check usage weekly, watch for spikes
 
-## 💰 ElevenLabs Usage & Costs
+### Tips to Manage Costs
 
-### **Important: Monitor Your Usage!**
+1. **Use selectively**: Disable TTS when doing quick edits
+   ```bash
+   /output-style default         # Turn off voice
+   /output-style agent-vibes     # Turn back on
+   ```
 
-AgentVibes generates TTS audio for **every task acknowledgment and completion** - this can add up quickly during active coding sessions!
+2. **Monitor analytics**: Check usage dashboard regularly
 
-### 📊 **Typical Usage Patterns**
+3. **Shorter messages**: "Normal" personality = shortest messages
 
-**Light coding (1-2 hours/day):**
-- ~50-100 TTS messages
-- ~2,500-5,000 characters/day
-- ✅ **Free tier works** (10,000 chars/month)
+4. **Upgrade proactively**: If coding 8+ hrs/day, start with Creator plan
 
-**Moderate coding (4-5 hours/day):**
-- ~200-300 TTS messages
-- ~10,000-15,000 characters/day
-- ⚠️ **Starter plan needed** ($5/month, 30,000 chars)
+### Useful Links
 
-**Heavy coding (8+ hours/day):**
-- ~400-600 TTS messages
-- ~20,000-30,000 characters/day
-- ⚠️ **Creator/Pro plan needed** ($22-$99/month)
-- 💡 **May need to upgrade mid-month** if coding intensively
+- 📊 **Usage Dashboard**: https://elevenlabs.io/app/usage
+- 💳 **Pricing Page**: https://elevenlabs.io/pricing
+- 🆘 **Support**: https://help.elevenlabs.io/
 
-### 💳 **ElevenLabs Pricing (2025)**
+[↑ Back to top](#-table-of-contents)
 
-| Plan | Monthly Cost | Characters/Month | Best For |
-|------|-------------|------------------|----------|
-| **Free** | $0 | 10,000 | Trying it out, light use |
-| **Starter** | $5 | 30,000 | Casual coding |
-| **Creator** | $22 | 100,000 | Regular coding |
-| **Pro** | $99 | 500,000 | Heavy daily use |
-| **Scale** | $330 | 2,000,000 | Professional/teams |
+---
 
-**Overage costs** (if you exceed your plan):
-- Creator: $0.30 per 1,000 characters
-- Pro: $0.24 per 1,000 characters
-- Scale: $0.18 per 1,000 characters
+## ❓ Troubleshooting
 
-### 📈 **Monitor Your Usage**
+### No Audio Playing?
 
-**Track your consumption in real-time:**
+1. Check API key: `echo $ELEVENLABS_API_KEY`
+2. Check output style: `/output-style agent-vibes`
+3. Test playback: `/agent-vibes:sample Aria`
 
-1. **Go to ElevenLabs Dashboard:**
-   - Visit: https://elevenlabs.io/app/usage
-   - Click "My Account" → "Usage Analytics"
-   - Or: "Developers" → "Usage" tab
+### Commands Not Found?
 
-2. **What to monitor:**
-   - ✅ **Credits used** - Daily and monthly totals
-   - ✅ **Character breakdown** - By voice/API key
-   - ✅ **Billing period alignment** - See when your plan resets
-   - ✅ **Export to CSV** - Download usage data
+```bash
+# Verify installation
+node ~/claude/AgentVibes/bin/agent-vibes status
+
+# Reinstall
+node ~/claude/AgentVibes/bin/agent-vibes install --yes
+```
 
-3. **Set up alerts:**
-   - Check your usage weekly
-   - Watch for unexpected spikes
-   - Upgrade before hitting limits
+### Wrong Voice Playing?
 
-### 💡 **Tips to Manage Costs**
+```bash
+# Check current setup
+/agent-vibes:whoami
 
-1. **Use selectively**: Disable TTS when doing quick edits
-   ```bash
-   /output-style default  # Turn off voice
-   /output-style agent-vibes  # Turn back on
-   ```
+# Reset if needed
+/agent-vibes:personality reset
+/agent-vibes:sentiment clear
+```
 
-2. **Monitor analytics**: Check https://elevenlabs.io/app/usage regularly
+[↑ Back to top](#-table-of-contents)
 
-3. **Shorter messages**: Personality styles affect message length
-   - "Normal" personality = shortest messages
-   - "Sarcastic/Grandpa" = longer messages
+---
 
-4. **Upgrade proactively**: If coding 8+ hours/day, start with Creator plan
+## 🔄 Updating
 
-### 🔗 **Useful Links**
+### If installed via npx:
+```bash
+npx agentvibes update --yes
+```
 
-- 📊 **Usage Dashboard**: https://elevenlabs.io/app/usage
-- 💳 **Pricing Page**: https://elevenlabs.io/pricing
-- 📖 **Usage Analytics Docs**: https://elevenlabs.io/docs/product-guides/administration/usage-analytics
-- 🆘 **Support**: https://help.elevenlabs.io/
+### If installed globally via npm:
+```bash
+npm update -g agentvibes
+agentvibes update --yes
+```
 
-### ⚠️ **Fair Warning**
+### If installed from source:
+```bash
+cd ~/AgentVibes
+git pull origin master
+npm install
+node bin/agent-vibes update --yes
+```
 
-If you're coding **8 hours/day with Claude Code**, expect to use:
-- ~600-800 TTS messages daily
-- ~30,000-40,000 characters daily
-- ~900,000-1,200,000 characters/month
+The update command will:
+- ✅ Update all slash commands
+- ✅ Update TTS scripts and plugins
+- ✅ Add new personalities (keeps your custom ones)
+- ✅ Update output styles
+- ⚠️  Preserves your voice settings and configurations
 
-**You'll likely need:**
-- **Pro plan ($99/month)** minimum
-- Or **Creator plan + overages** (~$140/month)
-- Possibly **two Pro subscriptions** if coding intensively 6-7 days/week
+[↑ Back to top](#-table-of-contents)
 
-**Always monitor your ElevenLabs analytics dashboard!** 📊
+---
 
 ## 🙏 Credits
 
@@ -542,11 +565,13 @@ If you're coding **8 hours/day with Claude Code**, expect to use:
 - 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) - Original inspiration for Claude Code customization and hooks
+- 💡 [Claude Code Hooks Mastery](https://github.com/disler/claude-code-hooks-mastery) by [@disler](https://github.com/disler)
+
+[↑ Back to top](#-table-of-contents)
 
 ---
 
-## 🤝 Show Some Love
+## 🤝 Contributing
 
 If AgentVibes makes your coding more fun:
 - ⭐ **Star this repo** on GitHub
@@ -557,3 +582,5 @@ If AgentVibes makes your coding more fun:
 ---
 
 **Ready to give Claude a voice? Install now and code with personality! 🎤✨**
+
+[↑ Back to top](#-table-of-contents)

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "Beautiful ElevenLabs TTS voice commands for Claude Code - Add professional narration to your AI coding sessions",
   "keywords": [
     "elevenlabs",

package/templates/output-styles/agent-vibes.md

@@ -115,6 +115,64 @@ You: "✅ That bug be walkin' the plank now, arr!"
 [Bash: .claude/hooks/play-tts.sh "That bug be walkin' the plank now, arr!"]
 ```
 
+## BMAD Plugin Integration
+
+**Automatic voice switching for BMAD agents:**
+
+When a BMAD agent is activated (e.g., `/BMad:agents:pm`), AgentVibes will automatically:
+
+1. **Detect BMAD agent from command/context**
+2. **Check if BMAD plugin is enabled** (`.claude/plugins/bmad-voices-enabled.flag`)
+3. **Look up voice mapping** from `.claude/plugins/bmad-voices.md`
+4. **Apply agent's assigned voice** for all TTS acknowledgments/completions
+5. **Apply agent's personality** from the mapping (if specified)
+
+**Implementation:**
+```bash
+# At the start of acknowledgment/completion:
+# Try to detect BMAD agent ID from current context
+BMAD_AGENT_ID=""
+
+# Method 1: Check if we're in a BMAD agent command context
+if [[ -f ".bmad-agent-context" ]]; then
+    BMAD_AGENT_ID=$(cat .bmad-agent-context 2>/dev/null)
+fi
+
+# Method 2: Parse from command history/context (fallback)
+# Note: This detection happens automatically when BMAD agent activates
+
+# If BMAD agent detected and plugin enabled, use mapped voice
+if [[ -n "$BMAD_AGENT_ID" ]] && [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
+    MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
+    MAPPED_PERSONALITY=$(.claude/hooks/bmad-voice-manager.sh get-personality "$BMAD_AGENT_ID")
+
+    if [[ -n "$MAPPED_VOICE" ]]; then
+        # Use BMAD agent's mapped voice and personality
+        if [[ -n "$MAPPED_PERSONALITY" ]] && [[ "$MAPPED_PERSONALITY" != "normal" ]]; then
+            # Read personality instructions from .claude/personalities/${MAPPED_PERSONALITY}.md
+            # Generate response in that personality style
+        fi
+        .claude/hooks/play-tts.sh "message" "$MAPPED_VOICE"
+        # Exit early - don't use default personality system
+        return
+    fi
+fi
+
+# If no BMAD agent or plugin disabled, use standard personality/sentiment system
+# ... continue with normal sentiment/personality logic ...
+```
+
+**BMAD Agent Context Tracking:**
+- When a BMAD agent activates, write agent ID to `.bmad-agent-context`
+- When agent exits, remove the file
+- This allows AgentVibes to know which BMAD agent is active
+
+**Voice Priority (in order):**
+1. BMAD plugin voice (if agent active and plugin enabled)
+2. Sentiment mode (if set)
+3. Personality mode (if set)
+4. Default voice
+
 ## Critical Rules
 
 1. **ALWAYS use Bash tool** to execute play-tts.sh