agentvibes 2.5.0 → 2.6.0

package/.claude/hooks/bmad-speak.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/bmad-speak.sh
+#
+# AgentVibes BMAD Voice Integration
+# Maps agent display names OR agent IDs to voices and triggers TTS
+#
+# Usage: bmad-speak.sh "Agent Name" "dialogue text"
+#        bmad-speak.sh "agent-id" "dialogue text"
+#
+# Supports both:
+# - Display names (e.g., "Winston", "John") for party mode
+# - Agent IDs (e.g., "architect", "pm") for individual agents
+#
+
+set -euo pipefail
+
+# Get script directory and project root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Arguments
+AGENT_NAME_OR_ID="$1"
+DIALOGUE="$2"
+
+# Remove backslash escaping that Claude might add for special chars like ! and $
+# In single quotes these don't need escaping, but Claude sometimes adds \! anyway
+DIALOGUE="${DIALOGUE//\\!/!}"
+DIALOGUE="${DIALOGUE//\\\$/\$}"
+
+# Check if party mode is enabled
+if [[ -f "$PROJECT_ROOT/.claude/plugins/bmad-party-mode-disabled.flag" ]]; then
+  exit 0
+fi
+
+# Check if BMAD is installed
+if [[ ! -f "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" ]]; then
+  exit 0
+fi
+
+# Map display name to agent ID, OR pass through if already an agent ID
+map_to_agent_id() {
+  local name_or_id="$1"
+
+  # If it looks like a file path (.bmad/*/agents/*.md), extract the agent ID
+  # Example: .bmad/bmm/agents/pm.md -> pm
+  if [[ "$name_or_id" =~ \.bmad/.*/agents/([^/]+)\.md$ ]]; then
+    echo "${BASH_REMATCH[1]}"
+    return
+  fi
+
+  # First check if it's already an agent ID (column 1 of manifest)
+  # CSV format: name,displayName,title,icon,role,...
+  local direct_match=$(grep -i "^\"*${name_or_id}\"*," "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" | head -1)
+  if [[ -n "$direct_match" ]]; then
+    # Already an agent ID, pass through
+    echo "$name_or_id"
+    return
+  fi
+
+  # Otherwise map display name to agent ID (for party mode)
+  # Extract 'name' (column 1) where displayName (column 2) matches
+  local agent_id=$(grep -i ",\"*${name_or_id}\"*," "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" | \
+                   head -1 | \
+                   cut -d',' -f1 | \
+                   tr -d '"')
+
+  echo "$agent_id"
+}
+
+# Get agent ID
+AGENT_ID=$(map_to_agent_id "$AGENT_NAME_OR_ID")
+
+# Get agent's voice
+AGENT_VOICE=""
+if [[ -n "$AGENT_ID" ]] && [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
+  AGENT_VOICE=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$AGENT_ID" 2>/dev/null)
+fi
+
+# Speak with agent's voice
+if [[ -n "$AGENT_VOICE" ]]; then
+  bash "$SCRIPT_DIR/play-tts.sh" "$DIALOGUE" "$AGENT_VOICE" &
+else
+  # Fallback to default voice
+  bash "$SCRIPT_DIR/play-tts.sh" "$DIALOGUE" &
+fi

package/.claude/hooks/bmad-tts-injector.sh

@@ -49,12 +49,17 @@ GRAY='\033[0;90m'
 NC='\033[0m' # No Color
 
 # Detect BMAD installation and version
-# Supports both v4 (.bmad-core/) and v6-alpha (bmad/) installations
+# Supports both v4 (.bmad-core/) and v6-alpha (.bmad/) installations
 detect_bmad() {
   local bmad_core_dir=""
 
-  # Check for v6-alpha first (newer version)
-  if [[ -d "bmad" ]]; then
+  # Check for v6-alpha first (newer version with dot prefix)
+  if [[ -d ".bmad" ]]; then
+    bmad_core_dir=".bmad"
+  elif [[ -d "../.bmad" ]]; then
+    bmad_core_dir="../.bmad"
+  # Check for v6-alpha without dot (legacy naming)
+  elif [[ -d "bmad" ]]; then
     bmad_core_dir="bmad"
   elif [[ -d "../bmad" ]]; then
     bmad_core_dir="../bmad"

package/.claude/hooks/stop.sh

@@ -0,0 +1,221 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/user-prompt-output.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
+# @fileoverview Auto-detects emoji markers and BMAD party mode in Claude's output and triggers TTS
+# @context Implements verbosity system by detecting 💭 🤔 ✓ markers and BMAD party mode agent dialogues
+# @architecture Stdin reader, regex matcher, async TTS trigger, agent voice switching
+# @dependencies play-tts.sh, tts-verbosity.txt, bmad-voice-manager.sh, .bmad/_cfg/agent-manifest.csv
+# @entrypoints Called by Claude Code after each assistant response (user-prompt-output hook)
+# @patterns Text stream processing, background job execution, marker-based triggers, party mode detection
+# @related session-start-tts.sh, verbosity-manager.sh, bmad-voice-manager.sh, Issue #32, Issue #33
+# @aiNotes This hook enables natural emoji-based TTS + BMAD party mode voice switching
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Get script directory and project root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PLAY_TTS="$SCRIPT_DIR/play-tts.sh"
+
+# Read JSON input from stdin
+INPUT=$(cat)
+
+# Extract transcript path from JSON
+TRANSCRIPT_PATH=$(echo "$INPUT" | grep -o '"transcript_path":"[^"]*"' | cut -d'"' -f4)
+
+# If no transcript path, exit (shouldn't happen but be safe)
+[[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]] && exit 0
+
+# Get the last assistant message from transcript
+# The transcript is JSONL format - each line is a JSON object
+# Extract all text content blocks from the last message and join them
+LAST_RESPONSE=$(tail -1 "$TRANSCRIPT_PATH" | jq -r '.message.content[] | select(.type == "text") | .text' 2>/dev/null)
+
+# Get verbosity level
+VERBOSITY=$(cat "$PROJECT_ROOT/.claude/tts-verbosity.txt" 2>/dev/null || cat ~/.claude/tts-verbosity.txt 2>/dev/null || echo "low")
+
+# Exit early if play-tts.sh doesn't exist (AgentVibes not installed)
+[[ ! -f "$PLAY_TTS" ]] && exit 0
+
+#
+# @function extract_and_speak
+# @context Extracts text after emoji markers and triggers TTS asynchronously
+# @architecture Uses grep to find markers, extracts text, launches TTS in background
+# @dependencies play-tts.sh
+# @entrypoints Called based on verbosity level
+# @aiNotes Background execution (&) prevents blocking Claude's output
+#
+extract_and_speak() {
+  local pattern="$1"
+
+  # Extract lines matching the pattern
+  # Pattern format: "emoji text" or "emoji [text]"
+  while IFS= read -r line; do
+    # Try to extract text after emoji
+    # Handles formats: "💭 text", "💭 [text]", "💭text"
+    if echo "$line" | grep -qE "$pattern"; then
+      # Extract everything after the emoji (and optional space/bracket)
+      text=$(echo "$line" | sed -E "s/^.*($pattern)[[:space:]]*\[?[[:space:]]*//" | sed 's/\]$//')
+
+      # Skip if text is empty or too short
+      [[ -z "$text" || ${#text} -lt 3 ]] && continue
+
+      # Speak it in background (don't block)
+      bash "$PLAY_TTS" "$text" >/dev/null 2>&1 &
+    fi
+  done <<< "$LAST_RESPONSE"
+}
+
+#
+# @function is_party_mode_enabled
+# @context Check if BMAD party mode voice integration is enabled
+# @architecture Auto-enable for BMAD users, opt-out via disable flag
+# @dependencies .bmad/_cfg/agent-manifest.csv, .claude/plugins/bmad-voices-enabled.flag
+# @returns 0=enabled, 1=disabled
+# @aiNotes Auto-enabled when BMAD detected, respects opt-out flag for user control
+#
+is_party_mode_enabled() {
+  # Explicit opt-out takes precedence
+  [[ -f "$PROJECT_ROOT/.claude/plugins/bmad-party-mode-disabled.flag" ]] && return 1
+
+  # Auto-enable if BMAD detected + voice plugin enabled
+  if [[ -f "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" ]] && \
+     [[ -f "$PROJECT_ROOT/.claude/plugins/bmad-voices-enabled.flag" ]]; then
+    return 0
+  fi
+
+  return 1
+}
+
+#
+# @function map_display_name_to_agent_id
+# @context Map BMAD agent display name to agent ID for voice lookup
+# @architecture Parses agent-manifest.csv, matches displayName column to name column
+# @dependencies .bmad/_cfg/agent-manifest.csv
+# @param $1 Display name (e.g., "Winston", "John", "Amelia")
+# @returns Agent ID (e.g., "architect", "pm", "dev") or empty string if not found
+# @aiNotes Case-insensitive matching, handles quoted CSV values
+#
+map_display_name_to_agent_id() {
+  local display_name="$1"
+
+  # Check for BMAD v6 manifest
+  if [[ ! -f "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" ]]; then
+    return 1
+  fi
+
+  # CSV format: name,displayName,title,icon,role,...
+  # Extract 'name' (column 1) where displayName (column 2) matches
+  # Case-insensitive grep, remove quotes, get first match
+  local agent_id=$(grep -i ",\"*${display_name}\"*," "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" | \
+                   head -1 | \
+                   cut -d',' -f1 | \
+                   tr -d '"')
+
+  echo "$agent_id"
+}
+
+#
+# @function detect_and_speak_party_mode_dialogue
+# @context Detect BMAD party mode agent responses and speak with agent-specific voices
+# @architecture Pattern matches [Agent Name]: format, maps to agent voice, triggers TTS
+# @dependencies map_display_name_to_agent_id, bmad-voice-manager.sh, play-tts.sh
+# @aiNotes Runs in background to avoid blocking, graceful fallback for unmapped agents
+#
+detect_and_speak_party_mode_dialogue() {
+  # Pattern: [Agent Name]: dialogue
+  # Must start at beginning of line, agent name can include spaces/hyphens
+  while IFS= read -r line; do
+    if echo "$line" | grep -qE '^\[([A-Za-z\s-]+)\]:'; then
+      # Extract agent display name and dialogue
+      local agent_name=$(echo "$line" | sed -E 's/^\[([A-Za-z\s-]+)\]:.*/\1/')
+      local dialogue=$(echo "$line" | sed -E 's/^\[[^]]+\]:[[:space:]]*//')
+
+      # Skip if dialogue is empty or too short
+      [[ -z "$dialogue" || ${#dialogue} -lt 3 ]] && continue
+
+      # Map display name to agent ID
+      local agent_id=$(map_display_name_to_agent_id "$agent_name")
+
+      # Get agent's voice from bmad-voice-manager.sh
+      local agent_voice=""
+      if [[ -n "$agent_id" ]] && [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
+        agent_voice=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$agent_id" 2>/dev/null)
+      fi
+
+      # Speak with agent's voice (or default if not mapped)
+      # Run in foreground to ensure audio completes
+      if [[ -n "$agent_voice" ]]; then
+        bash "$PLAY_TTS" "$dialogue" "$agent_voice" &
+      else
+        # Fallback to default voice if agent not in voice mapping
+        bash "$PLAY_TTS" "$dialogue" &
+      fi
+    fi
+  done
+}
+
+# Process based on verbosity level
+case "$VERBOSITY" in
+  high)
+    # HIGH: Speak ALL markers (💭 🤔 ✓)
+    # Don't speak ✅ here - that's handled by manual TTS completion call
+    extract_and_speak "💭|🤔|✓"
+    ;;
+
+  medium)
+    # MEDIUM: Speak decisions and findings (🤔 ✓)
+    extract_and_speak "🤔|✓"
+    ;;
+
+  low)
+    # LOW: No automatic extraction (only manual ACK/COMPLETE TTS calls)
+    # Don't process any markers
+    ;;
+esac
+
+# BMAD Party Mode Integration (Issue #33)
+# Auto-enabled for BMAD users, opt-out available
+if is_party_mode_enabled; then
+  # Detect party mode activation announcement
+  if echo "$LAST_RESPONSE" | grep -q "🎉 PARTY MODE ACTIVATED! 🎉"; then
+    bash "$PLAY_TTS" "Party Mode Activated! All agents are here for a group discussion!" &
+  fi
+
+  # Detect agent dialogues
+  echo "$LAST_RESPONSE" | detect_and_speak_party_mode_dialogue
+fi
+
+# Exit successfully
+exit 0

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

@@ -13,16 +13,16 @@ This plugin automatically assigns voices to BMAD agents based on their role and
 
 | Agent ID | Agent Name | ElevenLabs Voice | Piper Voice | Personality |
 |----------|------------|------------------|-------------|-------------|
-| pm | John (Product Manager) | Jessica Anne Bogart | en_US-ryan-high | professional |
-| dev | James (Developer) | Matthew Schmitz | en_US-joe-medium | normal |
-| qa | Quinn (QA) | Aria | en_US-amy-medium | professional |
+| pm | John (Product Manager) | Matthew Schmitz | en_US-ryan-high | professional |
+| dev | Amelia (Developer) | Aria | en_US-amy-medium | normal |
+| analyst | Mary (Business Analyst) | Jessica Anne Bogart | kristin | normal |
 | architect | Winston (Architect) | Michael | en_GB-alan-medium | normal |
-| po | Product Owner | Aria | en_US-amy-medium | professional |
-| analyst | Analyst | Matthew Schmitz | kristin | normal |
-| sm | Scrum Master | Jessica Anne Bogart | kristin | professional |
-| ux-expert | UX Expert | Aria | jenny | normal |
-| bmad-master | BMAD Master | Michael | en_GB-alan-medium | zen |
-| bmad-orchestrator | Orchestrator | Matthew Schmitz | en_US-ryan-high | professional |
+| sm | Bob (Scrum Master) | Matthew Schmitz | en_US-joe-medium | professional |
+| tea | Murat (Test Architect) | Michael | en_US-arctic-medium | normal |
+| tech-writer | Paige (Technical Writer) | Aria | jenny | normal |
+| ux-designer | Sally (UX Designer) | Jessica Anne Bogart | en_US-lessac-medium | normal |
+| frame-expert | Saif (Visual Designer) | Matthew Schmitz | en_GB-alan-medium | normal |
+| bmad-master | BMad Master | Michael | en_US-danny-low | zen |
 
 ## How It Works
 
@@ -32,6 +32,22 @@ The voice manager automatically selects the appropriate voice based on your acti
 
 This ensures BMAD agents work seamlessly regardless of which provider you're using.
 
+### Supports Both Display Names and Agent IDs
+
+The `bmad-speak.sh` script accepts both formats:
+
+**Party Mode** (multiple agents, uses display names):
+```bash
+.claude/hooks/bmad-speak.sh "Winston" "I recommend microservices for scalability"
+```
+
+**Individual Agents** (single agent sessions, uses agent IDs):
+```bash
+.claude/hooks/bmad-speak.sh "architect" "I recommend microservices for scalability"
+```
+
+Both formats map to the same voice configuration based on the agent ID in the table above. This allows BMAD to use customizable display names while maintaining stable voice mappings.
+
 ## How to Edit
 
 Simply edit the table above to change voice mappings. The format is:

package/README.md

@@ -94,16 +94,16 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.5.0 - Verbosity Control System](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.5.0)** 🎉
+**[v2.6.0 - BMAD Integration & Voice Management CLI](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.6.0)** 🎉
 
-This minor release introduces intelligent verbosity control - giving you precise control over how much Claude speaks while working.
+AgentVibes v2.6.0 brings comprehensive BMAD integration with unique AI voices for all agents! BMAD is a revolutionary AI-driven agile framework that automatically adapts from single bug fixes to enterprise-scale systems.
 
 **Key highlights:**
-- 🎙️ **Verbosity Control** - Three levels: LOW (minimal), MEDIUM (balanced), HIGH (full transparency)
-- 💭 **Emoji Markers** - Uses 💭 🤔 ✓ for automatic TTS detection
-- ⚙️ **Slash Command** - `/agent-vibes:verbosity [low|medium|high]`
-- 🔌 **MCP Integration** - Control via natural language
-- 🎯 **Smart Detection** - No manual Bash calls needed
+- 🎙️ **BMAD TTS Integration** - All BMAD agents can now speak with unique voices
+- 🛠️ **Voice Management CLI** - 5 new commands for managing agent voices
+- 🔍 **Fuzzy Voice Matching** - Use short names like "ryan" instead of full voice IDs
+- 📚 **Improved Help** - Built-in help command lists all available commands
+- 🔧 **BMAD v6 Support** - Detects and works with latest BMAD folder structure
 
 [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
 

package/RELEASE_NOTES.md

@@ -1,3 +1,258 @@
+# Release v2.6.0 - BMAD Integration & Voice Management CLI
+
+**Release Date:** 2025-11-18
+**Type:** Minor Release (New Features)
+
+## 🎯 AI Summary
+
+**What is BMAD?** BMAD (Building Multi-Agent Development) is a revolutionary AI-driven agile framework for software and game development. It automatically adapts from single bug fixes to enterprise-scale systems. AgentVibes whole-heartedly supports BMAD by providing Text to Speech capabilities, enabling great flow for developers working with BMAD when developing code.
+
+AgentVibes v2.6.0 brings comprehensive BMAD integration, enabling all BMAD agents to speak with unique AI voices. This release includes a provider-agnostic TTS injection system, five new CLI commands for easy voice management, and improved user experience with fuzzy voice matching and help documentation.
+
+**Key Highlights:**
+- 🎙️ **BMAD TTS Integration** - All BMAD agents can now speak with unique voices
+- 🛠️ **Voice Management CLI** - 5 new commands for managing agent voices
+- 🔍 **Fuzzy Voice Matching** - Use short names like "ryan" instead of full voice IDs
+- 📚 **Improved Help** - Built-in help command lists all available commands
+- 🔧 **BMAD v6 Support** - Detects and works with latest BMAD folder structure
+
+---
+
+## ✨ New Features
+
+### BMAD Integration
+
+**TTS Injection System** (commits: bedbc783, a2203ffa)
+- Provider-agnostic `TTS_INJECTION` marker system
+- Automatic detection and injection during BMAD installation
+- Works with both `.bmad/` (v6) and `bmad/` (legacy) folders
+- Supports individual agent voices and party mode multi-agent discussions
+
+**Voice Assignment** (commits: 361c522a, 3cef9d1c)
+- Auto-creates default voice assignments for 10 BMAD agents
+- Each agent gets a unique voice matching their personality:
+  - PM (John) - Professional male voice
+  - Architect (Marcus) - Deep authoritative voice
+  - Developer (Alex) - Casual friendly voice
+  - Analyst (Emma) - Articulate female voice
+  - UX Designer (Sara) - Warm professional voice
+  - And 5 more specialized voices
+- Smart folder detection prevents false legacy warnings
+
+**Agent ID Support** (commits: 638a3d75, 3e6fe609)
+- Extracts agent IDs from file paths (`.bmad/bmm/agents/pm.md` → `pm`)
+- Strips escaped special characters to prevent speech artifacts
+- Supports both agent IDs and display names
+
+### Voice Management CLI
+
+**5 New Commands** (commit: 560e51bb)
+1. `npx agentvibes preview-voice <voice-name>` - Preview any voice with sample text
+2. `npx agentvibes list-available-voices` - Show all Piper TTS voices
+3. `npx agentvibes list-bmad-assigned-voices` - Show current agent assignments
+4. `npx agentvibes assign-voice <agent-id> <voice-name>` - Change voice assignments
+5. `npx agentvibes reset-bmad-voices` - Reset all agents to defaults
+
+### User Experience Improvements
+
+**Fuzzy Voice Matching** (commit: b4160ab0)
+- Use short names: `npx agentvibes preview-voice ryan`
+- Automatically matches to full voice ID: `en_US-ryan-high`
+- Shows friendly "Matched 'ryan' to 'en_US-ryan-high'" message
+- Prevents accidental download prompts
+
+**Help Command** (commit: 45409a3a)
+- `npx agentvibes help` - Lists all available commands
+- Also works with `--help` and `-h` flags
+- Properly configured CLI metadata (name, description, version)
+
+### Technical Improvements
+
+**BMAD v6 Detection** (commit: e75be413)
+- Updated `bmad-detector.js` to detect `.bmad/` folder structure
+- Updated `bmad-tts-injector.sh` to prioritize `.bmad/` over `bmad/`
+- Maintains backward compatibility with legacy `bmad/` folders
+
+---
+
+## 🐛 Bug Fixes
+
+**Voice Assignment Creation** (commit: 3cef9d1c)
+- Fixed: Voice assignments weren't created when AgentVibes installed before BMAD
+- Solution: Only create assignments if `.bmad/` folder already exists
+- Prevents false "legacy BMAD v4" detection warnings
+
+**Special Character Handling** (commit: 3e6fe609)
+- Fixed: Escaped characters (like `\!`) in speech caused artifacts
+- Solution: Strip escape sequences before sending text to TTS
+- Clean speech output without "backslash exclamation" sounds
+
+**Agent ID Extraction** (commit: 638a3d75)
+- Fixed: File paths weren't properly converted to agent IDs
+- Solution: Extract basename from paths like `.bmad/bmm/agents/pm.md`
+- Correct voice assignment lookup for all agents
+
+---
+
+## 📦 Chores & Maintenance
+
+**.gitignore Updates** (commit: e75be413)
+- Added `.bmad/` folder (BMAD v6 installations)
+- Added `.mcp.json` (user-specific MCP config)
+- Added documentation patterns (screenshots, drafts, release notes)
+- Removed obsolete `user-prompt-output.sh` hook
+
+---
+
+## 🔧 Technical Details
+
+### Files Added
+- `src/commands/bmad-voices.js` (388 lines) - Voice management commands module
+
+### Files Modified
+- `src/installer.js` - Added CLI command definitions and program config
+- `src/bmad-detector.js` - Updated for `.bmad/` folder detection
+- `.claude/hooks/bmad-speak.sh` - Enhanced agent ID and path handling
+- `.claude/hooks/bmad-tts-injector.sh` - Added `.bmad/` detection
+- `.gitignore` - Comprehensive ignore patterns
+
+### GitHub Issues Resolved
+- #36 - Support BMAD agent IDs in bmad-speak.sh
+- #37 - Add CLI commands for BMAD voice management
+
+---
+
+## 📊 Stats
+
+- **Commits:** 10
+- **Files Changed:** 8
+- **Lines Added:** ~600
+- **Lines Removed:** ~150
+- **New Commands:** 5
+- **Issues Closed:** 2
+
+---
+
+## 🚀 Upgrade Guide
+
+### From v2.5.0
+
+**No breaking changes** - this is a backward-compatible feature release.
+
+To get the new features:
+
+```bash
+# Update AgentVibes
+npx agentvibes update
+
+# If you have BMAD installed, voice assignments will be created automatically
+# Test the new commands:
+npx agentvibes help
+npx agentvibes list-available-voices
+npx agentvibes preview-voice ryan
+```
+
+---
+
+## 💡 Usage Examples
+
+### Preview Voices (New Fuzzy Matching)
+```bash
+# Short names now work!
+npx agentvibes preview-voice ryan
+npx agentvibes preview-voice kristin
+npx agentvibes preview-voice danny
+
+# Full names still work
+npx agentvibes preview-voice en_US-ryan-high
+```
+
+### Manage BMAD Agent Voices
+```bash
+# List all available voices
+npx agentvibes list-available-voices
+
+# See current BMAD agent assignments
+npx agentvibes list-bmad-assigned-voices
+
+# Change an agent's voice
+npx agentvibes assign-voice pm en_US-danny-low
+
+# Reset all agents to defaults
+npx agentvibes reset-bmad-voices
+```
+
+### Get Help
+```bash
+# All these work:
+npx agentvibes help
+npx agentvibes --help
+npx agentvibes -h
+```
+
+---
+
+## 🤝 Contributors
+
+- Paul Preibisch (@paulpreibisch)
+- Claude AI (code generation assistant)
+
+---
+
+## 📝 Notes
+
+### BMAD Installation Order
+
+For automatic voice assignment setup, install BMAD first, then AgentVibes:
+
+```bash
+npx bmad install
+npx agentvibes install
+```
+
+If you install AgentVibes first, you'll need to manually create voice assignments:
+
+```bash
+mkdir -p .bmad/_cfg
+cat > .bmad/_cfg/agent-voice-map.csv << 'EOF'
+agent_id,voice_name
+pm,en_US-ryan-high
+architect,en_US-danny-low
+dev,en_US-joe-medium
+analyst,en_US-amy-medium
+ux-designer,en_US-kristin-medium
+tea,en_US-lessac-medium
+sm,en_US-bryce-medium
+tech-writer,en_US-kathleen-low
+frame-expert,en_US-kusal-medium
+bmad-master,en_US-libritts_r-high
+EOF
+```
+
+### Provider-Agnostic Design
+
+The `TTS_INJECTION` marker system is intentionally generic. Future TTS providers can integrate by:
+1. Creating a hook script at `.claude/hooks/bmad-speak.sh`
+2. Implementing the interface: `bmad-speak.sh <agent-id> <text>`
+3. BMAD will automatically detect and use the custom implementation
+
+---
+
+## 🔗 Links
+
+- **npm Package:** https://www.npmjs.com/package/agentvibes
+- **GitHub Repository:** https://github.com/paulpreibisch/AgentVibes
+- **GitHub Release:** https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.6.0
+- **BMAD Integration PR:** (To be created in BMAD-METHOD repository)
+- **Issue #36:** https://github.com/paulpreibisch/AgentVibes/issues/36
+- **Issue #37:** https://github.com/paulpreibisch/AgentVibes/issues/37
+
+---
+
+**Full Changelog:** https://github.com/paulpreibisch/AgentVibes/compare/v2.5.0...v2.6.0
+
+---
+
 # Release v2.4.3 - macOS Compatibility Fixes (2025-01-15)
 
 ## 🤖 AI Summary

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [