agentvibes 2.0.6 → 2.0.8

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

@@ -1,16 +1,17 @@
 ---
-description: Preview ElevenLabs TTS voices by playing audio samples
+description: Preview TTS voices by playing audio samples (provider-aware)
 argument-hint: [voice_name|first|last] [N]
 ---
 
-Preview ElevenLabs TTS voices by playing audio samples.
+Preview TTS voices by playing audio samples from your active provider.
 
 Usage examples:
 - `/agent-vibes:preview` - Preview first 3 voices (default)
 - `/agent-vibes:preview 5` - Preview first 5 voices
-- `/agent-vibes:preview Jessica` - Preview Jessica Anne Bogart voice
+- `/agent-vibes:preview Jessica` - Preview Jessica Anne Bogart voice (ElevenLabs)
+- `/agent-vibes:preview lessac` - Preview Lessac voice (Piper)
 - `/agent-vibes:preview "Northern Terry"` - Preview Northern Terry voice
 - `/agent-vibes:preview first 10` - Preview first 10 voices
 - `/agent-vibes:preview last 5` - Preview last 5 voices
 
-!bash .claude/hooks/voice-manager.sh preview $ARGUMENTS
+!bash .claude/hooks/provider-commands.sh preview $ARGUMENTS

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

@@ -1,7 +1,7 @@
 ---
-description: Show the current active voice
+description: Show the current active voice and TTS provider
 ---
 
-Display the currently selected ElevenLabs TTS voice.
+Display the currently selected TTS voice and active provider (ElevenLabs or Piper).
 
 !bash .claude/hooks/voice-manager.sh whoami

package/.claude/hooks/check-output-style.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+#
+# @fileoverview Output Style Detection for AgentVibes
+# @context Detects if agent-vibes output style is active
+# @architecture Helper for slash commands to warn users
+# @why Voice commands won't work without agent-vibes output style
+#
+
+# Check if we're in a Claude Code session with agent-vibes output style
+# This is a heuristic check - we can't directly detect the output style,
+# but we can check if TTS commands would work
+
+check_output_style() {
+  # Strategy: Check if this script is being called from within a Claude response
+  # If CLAUDECODE env var is set, we're in Claude Code
+  # If not, we're running standalone (not in a Claude Code session)
+
+  if [[ -z "$CLAUDECODE" ]]; then
+    # Not in Claude Code at all
+    return 1
+  fi
+
+  # We're in Claude Code, but we can't directly detect output style
+  # The agent-vibes output style calls our TTS hooks automatically
+  # So if this function is called, it means a slash command was invoked
+
+  # Check if we have the necessary TTS setup
+  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+  # Check if agent-vibes output style is installed
+  if [[ ! -f "$SCRIPT_DIR/../output-styles/agent-vibes.md" ]]; then
+    return 1
+  fi
+
+  # All checks passed - likely using agent-vibes output style
+  return 0
+}
+
+# Show warning if output style is not agent-vibes
+show_output_style_warning() {
+  echo ""
+  echo "⚠️  Voice commands require the agent-vibes output style"
+  echo ""
+  echo "To enable voice narration, run:"
+  echo "  /output-style agent-vibes"
+  echo ""
+  echo "This will make Claude speak with TTS for all responses."
+  echo "You can still use voice commands manually with agent-vibes disabled,"
+  echo "but you won't hear automatic TTS narration."
+  echo ""
+}
+
+# Main execution when called directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  if ! check_output_style; then
+    show_output_style_warning
+    exit 1
+  fi
+  exit 0
+fi

package/.claude/hooks/language-manager.sh

@@ -139,52 +139,54 @@ get_best_voice_for_language() {
     echo "${LANGUAGE_VOICES[$lang]}"
 }
 
-# Main command handler
-case "${1:-}" in
-    set)
-        if [[ -z "$2" ]]; then
-            echo "Usage: language-manager.sh set <language>"
+# Main command handler - only run if script is executed directly, not sourced
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    case "${1:-}" in
+        set)
+            if [[ -z "$2" ]]; then
+                echo "Usage: language-manager.sh set <language>"
+                exit 1
+            fi
+            set_language "$2"
+            ;;
+        get)
+            get_language
+            ;;
+        code)
+            get_language_code
+            ;;
+        check-voice)
+            if [[ -z "$2" ]]; then
+                echo "Usage: language-manager.sh check-voice <voice-name>"
+                exit 1
+            fi
+            if is_voice_multilingual "$2"; then
+                echo "yes"
+            else
+                echo "no"
+            fi
+            ;;
+        best-voice)
+            get_best_voice_for_language
+            ;;
+        list)
+            echo "Supported languages and recommended voices:"
+            echo ""
+            for lang in "${!LANGUAGE_VOICES[@]}"; do
+                printf "%-15s → %s\n" "$lang" "${LANGUAGE_VOICES[$lang]}"
+            done | sort
+            ;;
+        *)
+            echo "AgentVibes Language Manager"
+            echo ""
+            echo "Usage:"
+            echo "  language-manager.sh set <language>     Set language"
+            echo "  language-manager.sh get                Get current language"
+            echo "  language-manager.sh code               Get language code only"
+            echo "  language-manager.sh check-voice <name> Check if voice is multilingual"
+            echo "  language-manager.sh best-voice         Get best voice for current language"
+            echo "  language-manager.sh list               List all supported languages"
             exit 1
-        fi
-        set_language "$2"
-        ;;
-    get)
-        get_language
-        ;;
-    code)
-        get_language_code
-        ;;
-    check-voice)
-        if [[ -z "$2" ]]; then
-            echo "Usage: language-manager.sh check-voice <voice-name>"
-            exit 1
-        fi
-        if is_voice_multilingual "$2"; then
-            echo "yes"
-        else
-            echo "no"
-        fi
-        ;;
-    best-voice)
-        get_best_voice_for_language
-        ;;
-    list)
-        echo "Supported languages and recommended voices:"
-        echo ""
-        for lang in "${!LANGUAGE_VOICES[@]}"; do
-            printf "%-15s → %s\n" "$lang" "${LANGUAGE_VOICES[$lang]}"
-        done | sort
-        ;;
-    *)
-        echo "AgentVibes Language Manager"
-        echo ""
-        echo "Usage:"
-        echo "  language-manager.sh set <language>     Set language"
-        echo "  language-manager.sh get                Get current language"
-        echo "  language-manager.sh code               Get language code only"
-        echo "  language-manager.sh check-voice <name> Check if voice is multilingual"
-        echo "  language-manager.sh best-voice         Get best voice for current language"
-        echo "  language-manager.sh list               List all supported languages"
-        exit 1
-        ;;
-esac
+            ;;
+    esac
+fi

package/.claude/hooks/personality-manager.sh

@@ -37,7 +37,10 @@ get_personality_data() {
       grep "^description:" "$file" | cut -d: -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
       ;;
     voice)
-      grep "^voice:" "$file" | cut -d: -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
+      grep "^elevenlabs_voice:" "$file" | cut -d: -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
+      ;;
+    piper_voice)
+      grep "^piper_voice:" "$file" | cut -d: -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
       ;;
     instructions)
       sed -n '/^## AI Instructions/,/^##/p' "$file" | sed '1d;$d'
@@ -122,7 +125,33 @@ case "$1" in
     echo "🎭 Personality set to: $PERSONALITY"
 
     # Check if personality has an assigned voice
-    ASSIGNED_VOICE=$(get_personality_data "$PERSONALITY" "voice")
+    # Detect active TTS provider
+    PROVIDER_FILE=""
+    if [[ -f "$CLAUDE_DIR/tts-provider.txt" ]]; then
+      PROVIDER_FILE="$CLAUDE_DIR/tts-provider.txt"
+    elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+      PROVIDER_FILE="$HOME/.claude/tts-provider.txt"
+    fi
+
+    ACTIVE_PROVIDER="elevenlabs"  # default
+    if [[ -n "$PROVIDER_FILE" ]]; then
+      ACTIVE_PROVIDER=$(cat "$PROVIDER_FILE")
+    fi
+
+    # Get the appropriate voice based on provider
+    ASSIGNED_VOICE=""
+    if [[ "$ACTIVE_PROVIDER" == "piper" ]]; then
+      # Try to get Piper-specific voice first
+      ASSIGNED_VOICE=$(get_personality_data "$PERSONALITY" "piper_voice")
+      if [[ -z "$ASSIGNED_VOICE" ]]; then
+        # Fallback to default Piper voice
+        ASSIGNED_VOICE="en_US-lessac-medium"
+      fi
+    else
+      # Use ElevenLabs voice (reads from elevenlabs_voice: field)
+      ASSIGNED_VOICE=$(get_personality_data "$PERSONALITY" "voice")
+    fi
+
     if [[ -n "$ASSIGNED_VOICE" ]]; then
       # Switch to the assigned voice (silently - personality will do the talking)
       VOICE_MANAGER="$SCRIPT_DIR/voice-manager.sh"
@@ -163,6 +192,9 @@ case "$1" in
 
       echo ""
       echo "Note: AI will generate unique ${PERSONALITY} responses - no fixed templates!"
+      echo ""
+      echo "💡 Tip: To hear automatic TTS narration, enable the agent-vibes output style:"
+      echo "   /output-style agent-vibes"
     fi
     ;;
 

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

@@ -32,22 +32,40 @@ DEFAULT_VOICE="en_US-lessac-medium"
 VOICE_MODEL=""
 
 # Get current language setting
-CURRENT_LANGUAGE=$(get_current_language)
+CURRENT_LANGUAGE=$(get_language_code)
 
 if [[ -n "$VOICE_OVERRIDE" ]]; then
   # Use override if provided
   VOICE_MODEL="$VOICE_OVERRIDE"
   echo "🎤 Using voice: $VOICE_OVERRIDE (session-specific)"
 else
-  # Try to get language-specific voice
-  LANG_VOICE=$(get_voice_for_language "$CURRENT_LANGUAGE" "piper" 2>/dev/null)
+  # Try to get voice from voice file (project-local first, then global)
+  VOICE_FILE=""
+  if [[ -f "$SCRIPT_DIR/../tts-voice.txt" ]]; then
+    VOICE_FILE="$SCRIPT_DIR/../tts-voice.txt"
+  elif [[ -f "$HOME/.claude/tts-voice.txt" ]]; then
+    VOICE_FILE="$HOME/.claude/tts-voice.txt"
+  fi
 
-  if [[ -n "$LANG_VOICE" ]]; then
-    VOICE_MODEL="$LANG_VOICE"
-    echo "🌍 Using $CURRENT_LANGUAGE voice: $LANG_VOICE (Piper)"
-  else
-    # Use default voice
-    VOICE_MODEL="$DEFAULT_VOICE"
+  if [[ -n "$VOICE_FILE" ]]; then
+    FILE_VOICE=$(cat "$VOICE_FILE" 2>/dev/null)
+    # Check if it's a Piper model name (contains underscore and dash)
+    if [[ "$FILE_VOICE" == *"_"*"-"* ]]; then
+      VOICE_MODEL="$FILE_VOICE"
+    fi
+  fi
+
+  # If no Piper voice from file, try language-specific voice
+  if [[ -z "$VOICE_MODEL" ]]; then
+    LANG_VOICE=$(get_voice_for_language "$CURRENT_LANGUAGE" "piper" 2>/dev/null)
+
+    if [[ -n "$LANG_VOICE" ]]; then
+      VOICE_MODEL="$LANG_VOICE"
+      echo "🌍 Using $CURRENT_LANGUAGE voice: $LANG_VOICE (Piper)"
+    else
+      # Use default voice
+      VOICE_MODEL="$DEFAULT_VOICE"
+    fi
   fi
 fi
 

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

@@ -1,138 +1,40 @@
 #!/bin/bash
-# Quick TTS playback script with session-specific voice support
-# Usage: play-tts.sh "Text to speak" [voice_name_or_id]
 #
-# Examples:
-#   play-tts.sh "Hello world"                           # Uses default voice from voice manager
-#   play-tts.sh "Hello world" "Sarah"                   # Uses Sarah voice by name
-#   play-tts.sh "Hello world" "KTPVrSVAEUSJRClDzBw7"   # Uses voice by direct ID
+# @fileoverview TTS Provider Router
+# @context Routes TTS requests to active provider (ElevenLabs or Piper)
+# @architecture Provider abstraction layer - single entry point for all TTS
+# @dependencies provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh
+# @entrypoints Called by hooks, slash commands, and personality-manager.sh
+# @patterns Provider pattern - delegates to provider-specific implementations
+# @related provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh
 #
-# This allows different sessions to use different voices for easy identification!
 
 # Fix locale warnings
 export LC_ALL=C
 
 TEXT="$1"
-VOICE_OVERRIDE="$2"  # Optional: voice name or direct voice ID
-API_KEY="${ELEVENLABS_API_KEY}"
+VOICE_OVERRIDE="$2"  # Optional: voice name or ID
 
-# Check for project-local pretext configuration
-CONFIG_DIR="${CLAUDE_PROJECT_DIR:-.}/.claude/config"
-CONFIG_FILE="$CONFIG_DIR/agentvibes.json"
-
-if [[ -f "$CONFIG_FILE" ]] && command -v jq &> /dev/null; then
-  PRETEXT=$(jq -r '.pretext // empty' "$CONFIG_FILE" 2>/dev/null)
-  if [[ -n "$PRETEXT" ]]; then
-    TEXT="$PRETEXT: $TEXT"
-  fi
-fi
-
-# Limit text length to prevent API issues (max 500 chars for safety)
-if [ ${#TEXT} -gt 500 ]; then
-  TEXT="${TEXT:0:497}..."
-  echo "⚠️ Text truncated to 500 characters for API safety"
-fi
-
-# Source the single voice configuration file
+# Get script directory
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/voices-config.sh"
-
-# Determine which voice to use
-VOICE_ID=""
-
-if [[ -n "$VOICE_OVERRIDE" ]]; then
-  # Check if override is a voice name (lookup in mapping)
-  if [[ -n "${VOICES[$VOICE_OVERRIDE]}" ]]; then
-    VOICE_ID="${VOICES[$VOICE_OVERRIDE]}"
-    echo "🎤 Using voice: $VOICE_OVERRIDE (session-specific)"
-  # Check if override looks like a voice ID (alphanumeric string ~20 chars)
-  elif [[ "$VOICE_OVERRIDE" =~ ^[a-zA-Z0-9]{15,30}$ ]]; then
-    VOICE_ID="$VOICE_OVERRIDE"
-    echo "🎤 Using custom voice ID (session-specific)"
-  else
-    echo "⚠️ Unknown voice '$VOICE_OVERRIDE', using default"
-  fi
-fi
-
-# If no override or invalid override, use default from voice manager
-if [[ -z "$VOICE_ID" ]]; then
-  VOICE_MANAGER_SCRIPT="$(dirname "$0")/voice-manager.sh"
-  if [[ -f "$VOICE_MANAGER_SCRIPT" ]]; then
-    VOICE_NAME=$("$VOICE_MANAGER_SCRIPT" get)
-    VOICE_ID="${VOICES[$VOICE_NAME]}"
-  fi
-
-  # Final fallback to Cowboy Bob default
-  if [[ -z "$VOICE_ID" ]]; then
-    echo "⚠️ No voice configured, using Cowboy Bob default"
-    VOICE_ID="${VOICES[Cowboy Bob]}"
-  fi
-fi
-
-if [ -z "$TEXT" ]; then
-  echo "Usage: $0 \"text to speak\""
-  exit 1
-fi
-
-if [ -z "$API_KEY" ]; then
-  echo "Error: ELEVENLABS_API_KEY not set"
-  exit 1
-fi
-
-# Create audio file in project-local storage
-# Use project directory if available, otherwise fall back to global
-if [[ -n "$CLAUDE_PROJECT_DIR" ]]; then
-  AUDIO_DIR="$CLAUDE_PROJECT_DIR/.claude/audio"
-else
-  # Fallback: try to find .claude directory in current path
-  CURRENT_DIR="$PWD"
-  while [[ "$CURRENT_DIR" != "/" ]]; do
-    if [[ -d "$CURRENT_DIR/.claude" ]]; then
-      AUDIO_DIR="$CURRENT_DIR/.claude/audio"
-      break
-    fi
-    CURRENT_DIR=$(dirname "$CURRENT_DIR")
-  done
-  # Final fallback to global if no project .claude found
-  if [[ -z "$AUDIO_DIR" ]]; then
-    AUDIO_DIR="$HOME/.claude/audio"
-  fi
-fi
-
-mkdir -p "$AUDIO_DIR"
-TEMP_FILE="$AUDIO_DIR/tts-$(date +%s).mp3"
-
-# Generate audio
-curl -s -X POST "https://api.elevenlabs.io/v1/text-to-speech/${VOICE_ID}" \
-  -H "xi-api-key: ${API_KEY}" \
-  -H "Content-Type: application/json" \
-  -d "{\"text\":\"${TEXT}\",\"model_id\":\"eleven_monolingual_v1\",\"voice_settings\":{\"stability\":0.5,\"similarity_boost\":0.75}}" \
-  -o "${TEMP_FILE}"
-
-# Add silence padding to prevent WSL audio static
-if [ -f "${TEMP_FILE}" ]; then
-  # Check if ffmpeg is available for adding padding
-  if command -v ffmpeg &> /dev/null; then
-    PADDED_FILE="$AUDIO_DIR/tts-padded-$(date +%s).mp3"
-    # Add 200ms of silence at the beginning to prevent static
-    ffmpeg -f lavfi -i anullsrc=r=44100:cl=stereo:d=0.2 -i "${TEMP_FILE}" \
-      -filter_complex "[0:a][1:a]concat=n=2:v=0:a=1[out]" \
-      -map "[out]" -y "${PADDED_FILE}" 2>/dev/null
-
-    if [ -f "${PADDED_FILE}" ]; then
-      # Use padded file and clean up original
-      rm -f "${TEMP_FILE}"
-      TEMP_FILE="${PADDED_FILE}"
-    fi
-    # If padding failed, just use original file
-  fi
 
-  # Play audio (WSL/Linux) in background to avoid blocking
-  (paplay "${TEMP_FILE}" 2>/dev/null || aplay "${TEMP_FILE}" 2>/dev/null || mpg123 "${TEMP_FILE}" 2>/dev/null) &
-  # Keep temp files for later review - cleaned up weekly by cron
-  echo "🎵 Saved to: ${TEMP_FILE}"
-  echo "🎤 Voice used: ${VOICE_NAME} (${VOICE_ID})"
-else
-  echo "Failed to generate audio"
-  exit 1
-fi
+# Source provider manager to get active provider
+source "$SCRIPT_DIR/provider-manager.sh"
+
+# Get active provider
+ACTIVE_PROVIDER=$(get_active_provider)
+
+# Route to appropriate provider implementation
+case "$ACTIVE_PROVIDER" in
+  elevenlabs)
+    exec "$SCRIPT_DIR/play-tts-elevenlabs.sh" "$TEXT" "$VOICE_OVERRIDE"
+    ;;
+  piper)
+    exec "$SCRIPT_DIR/play-tts-piper.sh" "$TEXT" "$VOICE_OVERRIDE"
+    ;;
+  *)
+    echo "❌ Unknown provider: $ACTIVE_PROVIDER"
+    echo "   Run: /agent-vibes:provider list"
+    exit 1
+    ;;
+esac

package/.claude/hooks/provider-commands.sh

@@ -292,10 +292,49 @@ provider_preview() {
       ;;
     piper)
       # Use the Piper voice manager's list functionality
-      # For Piper, we'll list and play sample from available voices
       source "$SCRIPT_DIR/piper-voice-manager.sh"
 
-      # Play intro announcement
+      # Check if a specific voice was requested
+      local voice_arg="$1"
+
+      if [[ -n "$voice_arg" ]]; then
+        # User requested a specific voice - check if it's a valid Piper voice
+        # Piper voice names are like: en_US-lessac-medium
+        # Try to find a matching voice model
+
+        # Check if the voice arg looks like a Piper model name (contains underscores/hyphens)
+        if [[ "$voice_arg" =~ ^[a-z]{2}_[A-Z]{2}- ]]; then
+          # Looks like a Piper voice model name
+          if verify_voice "$voice_arg"; then
+            echo "🎤 Previewing Piper voice: $voice_arg"
+            echo ""
+            "$SCRIPT_DIR/play-tts.sh" "Hello, this is the $voice_arg voice. How do you like it?" "$voice_arg"
+          else
+            echo "❌ Voice model not found: $voice_arg"
+            echo ""
+            echo "💡 Piper voice names look like: en_US-lessac-medium"
+            echo "   Run /agent-vibes:list to see available Piper voices"
+          fi
+        else
+          # Looks like an ElevenLabs voice name (like "Antoni", "Jessica")
+          echo "❌ '$voice_arg' appears to be an ElevenLabs voice"
+          echo ""
+          echo "You're currently using Piper TTS (free provider)."
+          echo "Piper has different voices than ElevenLabs."
+          echo ""
+          echo "Options:"
+          echo "  1. Run /agent-vibes:list to see available Piper voices"
+          echo "  2. Switch to ElevenLabs: /agent-vibes:provider switch elevenlabs"
+          echo ""
+          echo "Popular Piper voices to try:"
+          echo "  • en_US-lessac-medium  (clear, professional)"
+          echo "  • en_US-amy-medium     (warm, friendly)"
+          echo "  • en_US-joe-medium     (casual, natural)"
+        fi
+        return
+      fi
+
+      # No specific voice - preview first 3 voices
       echo "🎤 Piper Preview of 3 people"
       echo ""
 

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

@@ -163,52 +163,77 @@ case "$1" in
       exit 0
     fi
 
-    # Check if input is a number
-    if [[ "$VOICE_NAME" =~ ^[0-9]+$ ]]; then
-      # Get voice array
-      VOICE_ARRAY=()
-      for voice in "${!VOICES[@]}"; do
-        VOICE_ARRAY+=("$voice")
-      done
+    # Detect active TTS provider
+    PROVIDER_FILE=""
+    if [[ -f "$CLAUDE_DIR/tts-provider.txt" ]]; then
+      PROVIDER_FILE="$CLAUDE_DIR/tts-provider.txt"
+    elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+      PROVIDER_FILE="$HOME/.claude/tts-provider.txt"
+    fi
 
-      # Sort the array
-      IFS=$'\n' SORTED_VOICES=($(sort <<<"${VOICE_ARRAY[*]}"))
-      unset IFS
+    ACTIVE_PROVIDER="elevenlabs"  # default
+    if [[ -n "$PROVIDER_FILE" ]]; then
+      ACTIVE_PROVIDER=$(cat "$PROVIDER_FILE")
+    fi
+
+    # If using Piper and voice name looks like a Piper model (contains underscore and dash)
+    # then skip ElevenLabs voice validation
+    if [[ "$ACTIVE_PROVIDER" == "piper" ]] && [[ "$VOICE_NAME" == *"_"*"-"* ]]; then
+      # This is a Piper model name, use it directly
+      FOUND="$VOICE_NAME"
+    else
+      # ElevenLabs voice lookup
+      # Check if input is a number
+      if [[ "$VOICE_NAME" =~ ^[0-9]+$ ]]; then
+        # Get voice array
+        VOICE_ARRAY=()
+        for voice in "${!VOICES[@]}"; do
+          VOICE_ARRAY+=("$voice")
+        done
+
+        # Sort the array
+        IFS=$'\n' SORTED_VOICES=($(sort <<<"${VOICE_ARRAY[*]}"))
+        unset IFS
 
-      # Get voice by number (adjust for 0-based index)
-      INDEX=$((VOICE_NAME - 1))
+        # Get voice by number (adjust for 0-based index)
+        INDEX=$((VOICE_NAME - 1))
 
-      if [[ $INDEX -ge 0 && $INDEX -lt ${#SORTED_VOICES[@]} ]]; then
-        VOICE_NAME="${SORTED_VOICES[$INDEX]}"
-        FOUND="${SORTED_VOICES[$INDEX]}"
+        if [[ $INDEX -ge 0 && $INDEX -lt ${#SORTED_VOICES[@]} ]]; then
+          VOICE_NAME="${SORTED_VOICES[$INDEX]}"
+          FOUND="${SORTED_VOICES[$INDEX]}"
+        else
+          echo "❌ Invalid number. Please choose between 1 and ${#SORTED_VOICES[@]}"
+          exit 1
+        fi
       else
-        echo "❌ Invalid number. Please choose between 1 and ${#SORTED_VOICES[@]}"
-        exit 1
+        # Check if voice exists (case-insensitive)
+        FOUND=""
+        for voice in "${!VOICES[@]}"; do
+          if [[ "${voice,,}" == "${VOICE_NAME,,}" ]]; then
+            FOUND="$voice"
+            break
+          fi
+        done
       fi
-    else
-      # Check if voice exists (case-insensitive)
-      FOUND=""
-      for voice in "${!VOICES[@]}"; do
-        if [[ "${voice,,}" == "${VOICE_NAME,,}" ]]; then
-          FOUND="$voice"
-          break
-        fi
-      done
-    fi
 
-    if [[ -z "$FOUND" ]]; then
-      echo "❌ Unknown voice: $VOICE_NAME"
-      echo ""
-      echo "Available voices:"
-      for voice in "${!VOICES[@]}"; do
-        echo "  - $voice"
-      done | sort
-      exit 1
+      if [[ -z "$FOUND" ]]; then
+        echo "❌ Unknown voice: $VOICE_NAME"
+        echo ""
+        echo "Available voices:"
+        for voice in "${!VOICES[@]}"; do
+          echo "  - $voice"
+        done | sort
+        exit 1
+      fi
     fi
 
     echo "$FOUND" > "$VOICE_FILE"
     echo "✅ Voice switched to: $FOUND"
-    echo "🎤 Voice ID: ${VOICES[$FOUND]}"
+
+    # Show voice ID only for ElevenLabs voices
+    if [[ "$ACTIVE_PROVIDER" != "piper" ]] && [[ -n "${VOICES[$FOUND]}" ]]; then
+      echo "🎤 Voice ID: ${VOICES[$FOUND]}"
+    fi
 
     # Have the new voice introduce itself (unless silent mode)
     if [[ "$SILENT_MODE" != "true" ]]; then
@@ -217,6 +242,10 @@ case "$1" in
       if [ -x "$PLAY_TTS" ]; then
         "$PLAY_TTS" "Hi, I'm $FOUND. I'll be your voice assistant moving forward." "$FOUND" > /dev/null 2>&1 &
       fi
+
+      echo ""
+      echo "💡 Tip: To hear automatic TTS narration, enable the agent-vibes output style:"
+      echo "   /output-style agent-vibes"
     fi
     ;;
 
@@ -232,6 +261,26 @@ case "$1" in
     echo "🎤 Current Voice Configuration"
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 
+    # Get active TTS provider
+    PROVIDER_FILE="$CLAUDE_DIR/tts-provider.txt"
+    if [[ ! -f "$PROVIDER_FILE" ]]; then
+      PROVIDER_FILE="$HOME/.claude/tts-provider.txt"
+    fi
+
+    if [ -f "$PROVIDER_FILE" ]; then
+      ACTIVE_PROVIDER=$(cat "$PROVIDER_FILE")
+      if [[ "$ACTIVE_PROVIDER" == "elevenlabs" ]]; then
+        echo "Provider: ElevenLabs (Premium AI)"
+      elif [[ "$ACTIVE_PROVIDER" == "piper" ]]; then
+        echo "Provider: Piper TTS (Free, Offline)"
+      else
+        echo "Provider: $ACTIVE_PROVIDER"
+      fi
+    else
+      # Default to ElevenLabs if no provider file
+      echo "Provider: ElevenLabs (Premium AI)"
+    fi
+
     # Get current voice
     if [ -f "$VOICE_FILE" ]; then
       CURRENT_VOICE=$(cat "$VOICE_FILE")