agentvibes 2.5.0 → 2.7.0

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

@@ -0,0 +1,225 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/bmad-party-manager.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 BMAD Party Mode Voice Integration Manager
+# @context Controls auto-enable/disable of multi-agent voice switching during BMAD party mode
+# @architecture Opt-out flag management, auto-detection, status reporting
+# @dependencies .bmad/_cfg/agent-manifest.csv, bmad-voices-enabled.flag, user-prompt-output.sh
+# @entrypoints /agent-vibes:bmad-party slash command
+# @patterns Auto-enable with opt-out, graceful degradation, feature detection
+# @related user-prompt-output.sh, bmad-voice-manager.sh, Issue #33
+
+# Fix locale warnings
+export LC_ALL=C
+
+PLUGIN_DIR=".claude/plugins"
+DISABLE_FLAG="$PLUGIN_DIR/bmad-party-mode-disabled.flag"
+BMAD_VOICES_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
+BMAD_MANIFEST=".bmad/_cfg/agent-manifest.csv"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+GRAY='\033[0;90m'
+NC='\033[0m' # No Color
+
+#
+# @function is_bmad_installed
+# @context Check if BMAD v6 is installed
+# @returns 0=installed, 1=not installed
+#
+is_bmad_installed() {
+  [[ -f "$BMAD_MANIFEST" ]]
+}
+
+#
+# @function is_bmad_voices_enabled
+# @context Check if BMAD voice plugin is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_bmad_voices_enabled() {
+  [[ -f "$BMAD_VOICES_FLAG" ]]
+}
+
+#
+# @function is_party_mode_enabled
+# @context Check if party mode voice integration is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_party_mode_enabled() {
+  # Disabled if opt-out flag exists
+  [[ -f "$DISABLE_FLAG" ]] && return 1
+
+  # Enabled if BMAD + voice plugin active
+  is_bmad_installed && is_bmad_voices_enabled
+}
+
+#
+# @function show_status
+# @context Display current party mode voice integration status
+#
+show_status() {
+  echo -e "${CYAN}🎭 BMAD Party Mode Voice Integration${NC}"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  # Check BMAD installation
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ BMAD not installed${NC}"
+    echo -e "${GRAY}   Party mode voice integration requires BMAD v6${NC}"
+    echo -e "${GRAY}   Install: https://github.com/bmad-method/bmad${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD v6 detected${NC}"
+
+  # Check voice plugin
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable: /agent-vibes:bmad enable${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD voice plugin enabled${NC}"
+
+  # Check party mode status
+  if is_party_mode_enabled; then
+    echo -e "${GREEN}✅ Party mode voices: ENABLED${NC}"
+    echo ""
+    echo -e "${CYAN}How it works:${NC}"
+    echo "  When you run /bmad:core:workflows:party-mode,"
+    echo "  each agent speaks with their unique voice:"
+    echo ""
+    echo "  🏗️  Winston (Architect) → Michael"
+    echo "  📋 John (PM) → Jessica Anne Bogart"
+    echo "  💻 Amelia (Dev) → Matthew Schmitz"
+    echo "  📊 Mary (Analyst) → kristin"
+    echo "  ... and more!"
+    echo ""
+    echo -e "${GRAY}Disable with: /agent-vibes:bmad-party disable${NC}"
+  else
+    echo -e "${YELLOW}⚠️  Party mode voices: DISABLED (opt-out active)${NC}"
+    echo ""
+    echo -e "${GRAY}Enable with: /agent-vibes:bmad-party enable${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function enable_party_mode
+# @context Enable party mode voice integration (remove opt-out flag)
+#
+enable_party_mode() {
+  # Verify prerequisites
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ Cannot enable: BMAD not installed${NC}"
+    echo -e "${GRAY}   Install BMAD v6 first${NC}"
+    return 1
+  fi
+
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ Cannot enable: BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable with: /agent-vibes:bmad enable${NC}"
+    return 1
+  fi
+
+  # Remove opt-out flag if it exists
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    rm -f "$DISABLE_FLAG"
+    echo -e "${GREEN}✅ Party mode voices enabled${NC}"
+    echo ""
+    echo -e "${CYAN}🎭 Multi-agent voice switching activated!${NC}"
+    echo "   Run /bmad:core:workflows:party-mode to hear agents speak"
+  else
+    echo -e "${GREEN}✅ Party mode voices already enabled${NC}"
+    echo ""
+    echo -e "${GRAY}(Auto-enabled when BMAD detected)${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function disable_party_mode
+# @context Disable party mode voice integration (create opt-out flag)
+#
+disable_party_mode() {
+  mkdir -p "$PLUGIN_DIR"
+
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    echo -e "${YELLOW}⚠️  Party mode voices already disabled${NC}"
+    return 0
+  fi
+
+  # Create opt-out flag
+  touch "$DISABLE_FLAG"
+
+  echo -e "${GREEN}✅ Party mode voices disabled${NC}"
+  echo ""
+  echo -e "${GRAY}Party mode will continue to work, but agents won't speak${NC}"
+  echo -e "${GRAY}Enable again with: /agent-vibes:bmad-party enable${NC}"
+  echo ""
+}
+
+# Main command dispatcher
+case "${1:-status}" in
+  enable)
+    enable_party_mode
+    ;;
+  disable)
+    disable_party_mode
+    ;;
+  status)
+    show_status
+    ;;
+  *)
+    echo -e "${CYAN}AgentVibes BMAD Party Mode Manager${NC}"
+    echo ""
+    echo "Usage: bmad-party-manager.sh {enable|disable|status}"
+    echo ""
+    echo "Commands:"
+    echo "  enable     Enable party mode voice integration"
+    echo "  disable    Disable party mode voice integration (opt-out)"
+    echo "  status     Show current status and configuration"
+    echo ""
+    echo "Party Mode Voice Integration:"
+    echo "  • Auto-enabled when BMAD v6 detected"
+    echo "  • Each agent speaks with unique voice during party mode"
+    echo "  • Opt-out available via disable command"
+    ;;
+esac

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

@@ -0,0 +1,110 @@
+#!/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) contains the name
+  # displayName format in CSV: "John", "Mary", "Winston", etc. (first word before any parentheses)
+  local agent_id=$(awk -F',' -v name="$name_or_id" '
+    BEGIN { IGNORECASE=1 }
+    NR > 1 {
+      # Extract displayName (column 2)
+      display = $2
+      gsub(/^"|"$/, "", display)  # Remove surrounding quotes
+
+      # Check if display name starts with the search name (case-insensitive)
+      # This handles both "John" and "John (Product Manager)"
+      if (tolower(display) ~ "^" tolower(name) "($| |\\()") {
+        # Extract agent ID (column 1)
+        agent = $1
+        gsub(/^"|"$/, "", agent)
+        print agent
+        exit
+      }
+    }
+  ' "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv")
+
+  echo "$agent_id"
+}
+
+# Get agent ID
+AGENT_ID=$(map_to_agent_id "$AGENT_NAME_OR_ID")
+
+# Get agent's voice and intro text
+AGENT_VOICE=""
+AGENT_INTRO=""
+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)
+  AGENT_INTRO=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-intro "$AGENT_ID" 2>/dev/null)
+fi
+
+# Prepend intro text if configured (e.g., "John, Product Manager here. [dialogue]")
+FULL_TEXT="$DIALOGUE"
+if [[ -n "$AGENT_INTRO" ]]; then
+  FULL_TEXT="${AGENT_INTRO}. ${DIALOGUE}"
+fi
+
+# Speak with agent's voice using queue system (non-blocking for Claude)
+# Queue system ensures sequential playback while allowing Claude to continue
+if [[ -n "$AGENT_VOICE" ]]; then
+  bash "$SCRIPT_DIR/tts-queue.sh" add "$FULL_TEXT" "$AGENT_VOICE" &
+else
+  # Fallback to default voice
+  bash "$SCRIPT_DIR/tts-queue.sh" add "$FULL_TEXT" &
+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/bmad-voice-manager.sh

@@ -34,14 +34,14 @@
 # @fileoverview BMAD Voice Plugin Manager - Maps BMAD agents to unique TTS voices
 # @context Enables each BMAD agent to have its own distinct voice for multi-agent sessions
 # @architecture Markdown table-based voice mapping with enable/disable flag, auto-detection of BMAD
-# @dependencies .claude/plugins/bmad-voices.md (voice mappings), bmad-tts-injector.sh, .bmad-core/ (BMAD installation)
+# @dependencies .claude/config/bmad-voices.md (voice mappings), bmad-tts-injector.sh, .bmad-core/ (BMAD installation)
 # @entrypoints Called by /agent-vibes:bmad commands, auto-enabled on BMAD detection
 # @patterns Plugin architecture, auto-enable on dependency detection, state backup/restore on toggle
-# @related bmad-tts-injector.sh, .claude/plugins/bmad-voices.md, .bmad-agent-context file
+# @related bmad-tts-injector.sh, .claude/config/bmad-voices.md, .bmad-agent-context file
 
-PLUGIN_DIR=".claude/plugins"
-PLUGIN_FILE="$PLUGIN_DIR/bmad-voices.md"
-ENABLED_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
+CONFIG_DIR=".claude/config"
+VOICE_CONFIG_FILE="$CONFIG_DIR/bmad-voices.md"
+ENABLED_FLAG="$CONFIG_DIR/bmad-voices-enabled.flag"
 
 # AI NOTE: Auto-enable pattern - When BMAD is detected via install-manifest.yaml,
 # automatically enable the voice plugin to provide seamless multi-agent voice support.
@@ -115,7 +115,7 @@ auto_enable_if_bmad_detected() {
     # Check if BMAD is installed (any version) and plugin not already enabled
     if [[ "$version" != "0" ]] && [[ ! -f "$ENABLED_FLAG" ]]; then
         # BMAD detected but plugin not enabled - enable it silently
-        mkdir -p "$PLUGIN_DIR"
+        mkdir -p "$CONFIG_DIR"
         touch "$ENABLED_FLAG"
         return 0
     fi
@@ -144,7 +144,7 @@ get_agent_voice() {
         return
     fi
 
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
         echo ""  # Plugin file missing
         return
     fi
@@ -163,19 +163,47 @@ get_agent_voice() {
     fi
 
     # Extract voice from markdown table based on provider
-    # Column 4 = ElevenLabs Voice, Column 5 = Piper Voice
-    local column=4  # Default to ElevenLabs (column 4)
+    # Table: Agent ID | Agent Name | Intro | ElevenLabs Voice | Piper Voice | Personality
+    # AWK columns: $1=empty | $2=ID | $3=Name | $4=Intro | $5=ElevenLabs | $6=Piper | $7=Personality
+    local column=5  # Default to ElevenLabs (AWK column 5)
     if [[ "$active_provider" == "piper" ]]; then
-        column=5  # Use Piper column
+        column=6  # Use Piper (AWK column 6)
     fi
 
-    local voice=$(grep "^| $agent_id " "$PLUGIN_FILE" | \
+    local voice=$(grep "^| $agent_id " "$VOICE_CONFIG_FILE" | \
                   awk -F'|' "{print \$$column}" | \
                   sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
 
     echo "$voice"
 }
 
+# @function get_agent_intro
+# @intent Retrieve intro text for BMAD agent (spoken before their message)
+# @why Helps users identify which agent is speaking in party mode
+# @param $1 {string} agent_id - BMAD agent identifier
+# @returns Echoes intro text to stdout, empty string if not configured
+# @exitcode Always 0
+# @sideeffects None
+# @edgecases Returns empty string if plugin file missing, parses column 3 of markdown table
+# @calledby bmad-speak.sh for agent identification in party mode
+# @calls grep, awk, sed
+# @version 2.1.0 - New function for customizable agent introductions
+get_agent_intro() {
+    local agent_id="$1"
+
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
+        echo ""
+        return
+    fi
+
+    # AWK column 4 = Intro text
+    local intro=$(grep "^| $agent_id " "$VOICE_CONFIG_FILE" | \
+                  awk -F'|' '{print $4}' | \
+                  sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+    echo "$intro"
+}
+
 # @function get_agent_personality
 # @intent Retrieve TTS personality assigned to specific BMAD agent
 # @why Agents may have distinct speaking styles (friendly, professional, energetic, etc.)
@@ -190,14 +218,14 @@ get_agent_voice() {
 get_agent_personality() {
     local agent_id="$1"
 
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
         echo ""
         return
     fi
 
-    # Column 6 = Personality (changed from 5 due to new ElevenLabs/Piper columns)
-    local personality=$(grep "^| $agent_id " "$PLUGIN_FILE" | \
-                       awk -F'|' '{print $6}' | \
+    # AWK column 7 = Personality
+    local personality=$(grep "^| $agent_id " "$VOICE_CONFIG_FILE" | \
+                       awk -F'|' '{print $7}' | \
                        sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
 
     echo "$personality"
@@ -229,10 +257,10 @@ is_plugin_enabled() {
 # @calledby Main command dispatcher with "enable" argument
 # @calls mkdir, cat, source, list_mappings, bmad-tts-injector.sh
 enable_plugin() {
-    mkdir -p "$PLUGIN_DIR"
+    mkdir -p "$CONFIG_DIR"
 
     # Save current settings before enabling
-    BACKUP_FILE="$PLUGIN_DIR/.bmad-previous-settings"
+    BACKUP_FILE="$CONFIG_DIR/.bmad-previous-settings"
 
     # Save current voice
     if [[ -f ".claude/tts-voice.txt" ]]; then
@@ -369,7 +397,7 @@ ACTIVATION_EOF
 # @calledby Main command dispatcher with "disable" argument
 # @calls source, rm, echo, bmad-tts-injector.sh
 disable_plugin() {
-    BACKUP_FILE="$PLUGIN_DIR/.bmad-previous-settings"
+    BACKUP_FILE="$CONFIG_DIR/.bmad-previous-settings"
 
     # Check if we have a backup to restore
     if [[ -f "$BACKUP_FILE" ]]; then
@@ -435,15 +463,15 @@ disable_plugin() {
 # @calledby enable_plugin, show_status, main command dispatcher with "list"
 # @calls grep, sed, echo
 list_mappings() {
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
-        echo "❌ Plugin file not found: $PLUGIN_FILE"
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
+        echo "❌ Plugin file not found: $VOICE_CONFIG_FILE"
         return 1
     fi
 
     echo "📊 BMAD Agent Voice Mappings:"
     echo ""
 
-    grep "^| " "$PLUGIN_FILE" | grep -v "Agent ID" | grep -v "^|---" | \
+    grep "^| " "$VOICE_CONFIG_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:]]*$//')
@@ -471,19 +499,19 @@ set_agent_voice() {
     local voice="$2"
     local personality="${3:-normal}"
 
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
-        echo "❌ Plugin file not found: $PLUGIN_FILE"
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
+        echo "❌ Plugin file not found: $VOICE_CONFIG_FILE"
         return 1
     fi
 
     # Check if agent exists
-    if ! grep -q "^| $agent_id " "$PLUGIN_FILE"; then
+    if ! grep -q "^| $agent_id " "$VOICE_CONFIG_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"
+    sed -i.bak "s/^| $agent_id |.*| .* | .* |$/| $agent_id | $(grep "^| $agent_id " "$VOICE_CONFIG_FILE" | awk -F'|' '{print $3}') | $voice | $personality |/" "$VOICE_CONFIG_FILE"
 
     echo "✅ Updated $agent_id → $voice [$personality]"
 }
@@ -531,12 +559,12 @@ show_status() {
 # @calledby Main command dispatcher with "edit" argument
 # @calls echo
 edit_plugin() {
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
-        echo "❌ Plugin file not found: $PLUGIN_FILE"
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
+        echo "❌ Plugin file not found: $VOICE_CONFIG_FILE"
         return 1
     fi
 
-    echo "Opening $PLUGIN_FILE for editing..."
+    echo "Opening $VOICE_CONFIG_FILE for editing..."
     echo "Edit the markdown table to change voice mappings"
 }
 
@@ -564,6 +592,9 @@ case "${1:-help}" in
     get-voice)
         get_agent_voice "$2"
         ;;
+    get-intro)
+        get_agent_intro "$2"
+        ;;
     get-personality)
         get_agent_personality "$2"
         ;;
@@ -571,7 +602,7 @@ case "${1:-help}" in
         edit_plugin
         ;;
     *)
-        echo "Usage: bmad-voice-manager.sh {enable|disable|status|list|set|get-voice|get-personality|edit}"
+        echo "Usage: bmad-voice-manager.sh {enable|disable|status|list|set|get-voice|get-intro|get-personality|edit}"
         echo ""
         echo "Commands:"
         echo "  enable              Enable BMAD voice plugin"
@@ -580,6 +611,7 @@ case "${1:-help}" in
         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-intro <id>      Get intro text for agent"
         echo "  get-personality <id> Get personality for agent"
         echo "  edit                Edit plugin configuration"
         exit 1

package/.claude/hooks/play-tts.sh

@@ -46,6 +46,11 @@ export LC_ALL=C
 TEXT="$1"
 VOICE_OVERRIDE="$2"  # Optional: voice name or ID
 
+# 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
+TEXT="${TEXT//\\!/!}"
+TEXT="${TEXT//\\\$/\$}"
+
 # Get script directory
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"