agentvibes 5.6.9 → 5.7.1

package/.agentvibes/config.json

@@ -1,40 +1,5 @@
 {
-  "defaultVoice": "libritts-speaker-925",
-  "ttsProvider": "piper",
-  "provider": "soprano",
-  "backgroundMusic": {
-    "enabled": false,
-    "track": "agent_vibes_japanese_city_pop_v1_loop.mp3",
-    "volume": 20
-  },
-  "music": {
-    "enabled": true,
-    "track": "agentvibes_nature_sounds_rain.mp3"
-  },
-  "musicFavorites": [
-    "agentvibes_blues_smooth_guitar.mp3",
-    "agentvibes_lofi_beats_coding.mp3",
-    "agentvibes_nature_sounds_rain.mp3",
-    "agent_vibes_ganawa_ambient_v2_loop.mp3"
-  ],
-  "effects": {
-    "reverb": true,
-    "reverbAmount": 0.6,
-    "pitch": 2,
-    "reverbPreset": "medium"
-  },
-  "verbosity": "high",
-  "personality": "grandpa",
-  "voice": "16Speakers::Cori_Samuel",
-  "pretext": "Agent Vibes Here",
-  "setupCompleted": true,
-  "ttsEngine": "piper",
-  "thumbsUp": [
-    "en_US-libritts-high::Adam",
-    "en_US-libritts_r-medium::Adam-2"
-  ],
-  "favorites": [
-    "en_US-libritts-high::Adam",
-    "en_US-libritts_r-medium::Adam-2"
-  ]
+  "audio_destination": "remote",
+  "audio_ssh_alias": "laptop-win",
+  "setupCompleted": true
 }

package/.claude/config/audio-effects.cfg

@@ -1,6 +1,6 @@
 
 llm:default|light||0.15|en_US-lessac-high||piper
-llm:claude-code|light|agent_vibes_chillwave_v2_loop.mp3|0.15|en_US-lessac-high|Claude Code here|piper
+llm:claude-code|light|agent_vibes_cumbia_v1_loop.mp3|0.05|en_US-libritts-high::Mike-3|Ubuntu RDP Agentvibes|piper
 llm:copilot|light|agent_vibes_bossa_nova_v2_loop.mp3|0.15|en_US-libritts-high::Anna-11|Copilot here|piper
 llm:codex|light|agent_vibes_chillwave_v2_loop.mp3|0.15|en_US-lessac-high|Codex here|piper
 llm:hermes|light|agent_vibes_bachata_v1_loop.mp3|0.15|en_US-libritts-high::Leo-8|Hermes here|piper

package/.claude/config/background-music-position.txt

@@ -16,14 +16,12 @@ Agent Vibes Ganawa Ambient v2-loop.mp3:.00000000000000000002815996
 Agent Vibes Tabla Dream Pop v1-loop.mp3:.00000000000000000009067943
 Agent Vibes ChillWave v2-loop.mp3:.00000000000000000007080511
 Agent Vibes Harpsichord v2-loop.mp3:.00000000000000000013140818
-agent_vibes_japanese_city_pop_v1_loop.mp3:6.054512
 agent_vibes_bossa_nova_v2_loop.mp3:5.369524
 agent_vibes_salsa_v2_loop.mp3:9.972790
 agent_vibes_arabic_v2_loop.mp3:.00000000000000000006132724
-agent_vibes_chillwave_v2_loop.mp3:14.628390
-agent_vibes_bachata_v1_loop.mp3:.00000000000000000005344000
-agent_vibes_goa_trance_v2_loop.mp3:.00000000000000000002499918
-agentvibes_soft_flamenco_loop.mp3:.00000000000000000014899091
-agent_vibes_celtic_harp_v1_loop.mp3:5.891973
-agent_vibes_dark_chill_step_loop.mp3:5.717823
-agent_vibes_cumbia_v1_loop.mp3:10.472018
+agent_vibes_cumbia_v1_loop.mp3:.00000000000000000010256000
+agent_vibes_bachata_v1_loop.mp3:5.125714
+agent_vibes_chillwave_v2_loop.mp3:.00000000000000000003308191
+Midnight Charleston Stomp.mp3:.00000000000000000010960000
+agent_vibes_japanese_city_pop_v1_loop.mp3:11.702675
+agentvibes_soft_flamenco_loop.mp3:9.589660

package/.claude/github-star-reminder.txt

@@ -1 +1 @@
-20260509
+20260511

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

@@ -49,7 +49,7 @@ 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/, _bmad/) installations
 detect_bmad() {
   local bmad_core_dir=""
 
@@ -58,6 +58,11 @@ detect_bmad() {
     bmad_core_dir=".bmad"
   elif [[ -d "../.bmad" ]]; then
     bmad_core_dir="../.bmad"
+  # Check for _bmad (current BMAD installer default — underscore prefix, project-local)
+  elif [[ -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"
@@ -73,6 +78,11 @@ detect_bmad() {
     bmad_core_dir="bmad-core"
   elif [[ -d "../bmad-core" ]]; then
     bmad_core_dir="../bmad-core"
+  # Check home-dir global BMAD install (~/_bmad is the default for standalone BMAD installs)
+  elif [[ -d "$HOME/_bmad" ]]; then
+    bmad_core_dir="$HOME/_bmad"
+  elif [[ -d "$HOME/.bmad" ]]; then
+    bmad_core_dir="$HOME/.bmad"
   else
     echo -e "${RED}❌ BMAD installation not found${NC}" >&2
     echo -e "${GRAY}   Looked for bmad/, .bmad-core/, or bmad-core/ directory${NC}" >&2
@@ -85,21 +95,34 @@ detect_bmad() {
 # Find all BMAD agents
 find_agents() {
   local bmad_core="$1"
-  local agents_dir=""
+  local found=0
+
+  # v6.6+: agents under .claude/skills/*/agents/ (new BMAD structure)
+  local skills_dir=".claude/skills"
+  if [[ -d "$skills_dir" ]]; then
+    while IFS= read -r -d '' agent_file; do
+      echo "$agent_file"
+      found=1
+    done < <(find "$skills_dir" -path "*/agents/*.md" -type f -print0 2>/dev/null)
+  fi
 
-  # Check for v6-alpha structure (bmad/bmm/agents/)
+  # v6.x: bmad/bmm/agents/
   if [[ -d "$bmad_core/bmm/agents" ]]; then
-    agents_dir="$bmad_core/bmm/agents"
-  # Check for v4 structure (.bmad-core/agents/)
-  elif [[ -d "$bmad_core/agents" ]]; then
-    agents_dir="$bmad_core/agents"
-  else
+    find "$bmad_core/bmm/agents" -name "*.md" -type f
+    found=1
+  fi
+
+  # v4: .bmad-core/agents/
+  if [[ -d "$bmad_core/agents" ]]; then
+    find "$bmad_core/agents" -name "*.md" -type f
+    found=1
+  fi
+
+  if [[ $found -eq 0 ]]; then
     echo -e "${RED}❌ Agents directory not found in $bmad_core${NC}" >&2
-    echo -e "${GRAY}   Tried: $bmad_core/bmm/agents/ and $bmad_core/agents/${NC}" >&2
+    echo -e "${GRAY}   Tried: $bmad_core/bmm/agents/, $bmad_core/agents/, .claude/skills/*/agents/${NC}" >&2
     return 1
   fi
-
-  find "$agents_dir" -name "*.md" -type f
 }
 
 # Check if agent has TTS injection
@@ -217,6 +240,15 @@ inject_tts() {
     return 0
   fi
 
+  # Detect format BEFORE creating backups — skip v6.6+ plain Markdown agents (no activation section)
+  local is_v6=false
+  if grep -q "<activation" "$agent_file"; then
+    is_v6=true
+  elif ! grep -q "activation-instructions:" "$agent_file"; then
+    echo -e "${GRAY}   ℹ️  Skipped (v6.6+ format): $(basename "$agent_file")${NC}"
+    return 2
+  fi
+
   # Create backup directory for centralized timestamped backups
   local backup_dir=".agentvibes/backups/agents"
   mkdir -p "$backup_dir"
@@ -231,15 +263,6 @@ inject_tts() {
 
   echo -e "${GRAY}   📦 Backup saved: $backup_dir/$backup_name${NC}"
 
-  # Detect v4 vs v6 structure
-  local is_v6=false
-  if grep -q "<activation" "$agent_file"; then
-    is_v6=true
-  elif ! grep -q "activation-instructions:" "$agent_file"; then
-    echo -e "${RED}❌ No activation section found in: $(basename "$agent_file")${NC}"
-    return 1
-  fi
-
   # Create TTS injection script based on version
   if [[ "$is_v6" == "true" ]]; then
     # v6 format: XML-style with <step n="4.5">
@@ -411,6 +434,7 @@ enable_all() {
   local agents=$(find_agents "$bmad_core")
   local success_count=0
   local skip_count=0
+  local format_skip_count=0
   local fail_count=0
 
   # Track modified files and backups for summary
@@ -423,7 +447,10 @@ enable_all() {
       continue
     fi
 
-    if inject_tts "$agent_file"; then
+    inject_tts "$agent_file" && local inject_result=0 || local inject_result=$?
+    if [[ $inject_result -eq 2 ]]; then
+      format_skip_count=$((format_skip_count + 1))
+    elif [[ $inject_result -eq 0 ]]; then
       success_count=$((success_count + 1))
       modified_files+=("$agent_file")
       # Track the backup file that was created
@@ -444,6 +471,7 @@ enable_all() {
   # Show results
   echo -e "${GREEN}✅ Successfully modified: $success_count agents${NC}"
   [[ $skip_count -gt 0 ]] && echo -e "${YELLOW}⏭️  Skipped (already enabled): $skip_count agents${NC}"
+  [[ $format_skip_count -gt 0 ]] && echo -e "${GRAY}   ℹ️  Skipped (v6.6+ format, not supported): $format_skip_count agents${NC}"
   [[ $fail_count -gt 0 ]] && echo -e "${RED}❌ Failed: $fail_count agents${NC}"
   echo ""
 

package/.claude/hooks/migrate-to-agentvibes.sh

@@ -46,22 +46,25 @@ echo -e "${BLUE}🔍 Checking for BMAD files in .claude/plugins/...${NC}"
 
 if [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
     echo -e "${YELLOW}  Found: bmad-voices-enabled.flag${NC}"
-    mv .claude/plugins/bmad-voices-enabled.flag .agentvibes/bmad/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
+    mv -n .claude/plugins/bmad-voices-enabled.flag .agentvibes/bmad/ && \
+        echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}" || \
+        echo -e "${YELLOW}  ⚠ Already exists in .agentvibes/bmad/ — skipped${NC}"
     MIGRATED=true
 fi
 
 if [[ -f ".claude/plugins/bmad-party-mode-disabled.flag" ]]; then
     echo -e "${YELLOW}  Found: bmad-party-mode-disabled.flag${NC}"
-    mv .claude/plugins/bmad-party-mode-disabled.flag .agentvibes/bmad/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
+    mv -n .claude/plugins/bmad-party-mode-disabled.flag .agentvibes/bmad/ && \
+        echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}" || \
+        echo -e "${YELLOW}  ⚠ Already exists in .agentvibes/bmad/ — skipped${NC}"
     MIGRATED=true
 fi
 
 if [[ -f ".claude/plugins/.bmad-previous-settings" ]]; then
     echo -e "${YELLOW}  Found: .bmad-previous-settings${NC}"
-    mv .claude/plugins/.bmad-previous-settings .agentvibes/bmad/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
+    mv -n .claude/plugins/.bmad-previous-settings .agentvibes/bmad/ && \
+        echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}" || \
+        echo -e "${YELLOW}  ⚠ Already exists in .agentvibes/bmad/ — skipped${NC}"
     MIGRATED=true
 fi
 
@@ -72,8 +75,9 @@ echo -e "${BLUE}🔍 Checking for BMAD files in .claude/config/...${NC}"
 
 if [[ -f ".claude/config/bmad-voices.md" ]]; then
     echo -e "${YELLOW}  Found: bmad-voices.md${NC}"
-    mv .claude/config/bmad-voices.md .agentvibes/bmad/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
+    mv -n .claude/config/bmad-voices.md .agentvibes/bmad/ && \
+        echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}" || \
+        echo -e "${YELLOW}  ⚠ Already exists in .agentvibes/bmad/ — skipped${NC}"
     MIGRATED=true
 fi
 
@@ -97,29 +101,33 @@ echo -e "${BLUE}🔍 Checking for AgentVibes config in .claude/config/...${NC}"
 
 if [[ -f ".claude/config/agentvibes.json" ]]; then
     echo -e "${YELLOW}  Found: agentvibes.json${NC}"
-    mv .claude/config/agentvibes.json .agentvibes/config/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
+    mv -n .claude/config/agentvibes.json .agentvibes/config/ && \
+        echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}" || \
+        echo -e "${YELLOW}  ⚠ Already exists in .agentvibes/config/ — skipped${NC}"
     MIGRATED=true
 fi
 
 if [[ -f ".claude/config/personality-voice-defaults.default.json" ]]; then
     echo -e "${YELLOW}  Found: personality-voice-defaults.default.json${NC}"
-    mv .claude/config/personality-voice-defaults.default.json .agentvibes/config/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
+    mv -n .claude/config/personality-voice-defaults.default.json .agentvibes/config/ && \
+        echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}" || \
+        echo -e "${YELLOW}  ⚠ Already exists in .agentvibes/config/ — skipped${NC}"
     MIGRATED=true
 fi
 
 if [[ -f ".claude/config/personality-voice-defaults.json" ]]; then
     echo -e "${YELLOW}  Found: personality-voice-defaults.json${NC}"
-    mv .claude/config/personality-voice-defaults.json .agentvibes/config/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
+    mv -n .claude/config/personality-voice-defaults.json .agentvibes/config/ && \
+        echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}" || \
+        echo -e "${YELLOW}  ⚠ Already exists in .agentvibes/config/ — skipped${NC}"
     MIGRATED=true
 fi
 
 if [[ -f ".claude/config/README-personality-defaults.md" ]]; then
     echo -e "${YELLOW}  Found: README-personality-defaults.md${NC}"
-    mv .claude/config/README-personality-defaults.md .agentvibes/config/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
+    mv -n .claude/config/README-personality-defaults.md .agentvibes/config/ && \
+        echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}" || \
+        echo -e "${YELLOW}  ⚠ Already exists in .agentvibes/config/ — skipped${NC}"
     MIGRATED=true
 fi
 

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

@@ -276,6 +276,13 @@ case "$1" in
       exit 1
     fi
 
+    # Validate name: alphanumeric, hyphens, underscores only — no path traversal
+    if [[ ! "$NAME" =~ ^[a-zA-Z0-9_-]+$ ]]; then
+      echo "❌ Invalid personality name '$NAME'"
+      echo "   Name must contain only letters, numbers, hyphens, and underscores"
+      exit 1
+    fi
+
     FILE="$PERSONALITIES_DIR/${NAME}.md"
     if [[ -f "$FILE" ]]; then
       echo "❌ Personality '$NAME' already exists"
@@ -306,8 +313,8 @@ Describe how the AI should generate messages for this personality.
 - "Example response 2"
 EOF
 
-    # Replace NAME with actual name
-    sed -i "s/NAME/$NAME/g" "$FILE"
+    # Replace NAME placeholder — use | as delimiter to avoid issues with / in paths
+    sed -i "s|NAME|${NAME}|g" "$FILE"
 
     echo "✅ Created new personality: $NAME"
     echo "📝 Edit the file: $FILE"
@@ -327,6 +334,12 @@ EOF
       exit 1
     fi
 
+    if [[ ! "$NAME" =~ ^[a-zA-Z0-9_-]+$ ]]; then
+      echo "❌ Invalid personality name '$NAME'"
+      echo "   Name must contain only letters, numbers, hyphens, and underscores"
+      exit 1
+    fi
+
     FILE="$PERSONALITIES_DIR/${NAME}.md"
     if [[ ! -f "$FILE" ]]; then
       echo "❌ Personality '$NAME' not found"

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

@@ -335,6 +335,12 @@ if [[ -n "$VOICE_OVERRIDE" ]]; then
   esac
 fi
 
+# Emit resolved voice and provider in verbose mode (used by tests and diagnostics)
+if [[ "${AGENTVIBES_VERBOSE:-0}" == "1" ]]; then
+  [[ -n "${VOICE_OVERRIDE:-}" ]] && echo "voice=${VOICE_OVERRIDE}" >&2
+  echo "provider=${ACTIVE_PROVIDER}" >&2
+fi
+
 # @function speak_text
 # @intent Route text to appropriate TTS provider
 # @why Reusable function for speaking, used by both single and learning modes

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

@@ -449,6 +449,14 @@ provider_preview() {
   echo "🎤 Voice Preview ($current_provider)"
   echo ""
 
+  # Detect routing LLM so preview audio reaches SSH/remote receivers
+  # (without --llm, play-tts.sh plays locally on headless servers instead of
+  # forwarding to the configured Windows/remote receiver)
+  local _preview_llm _preview_llm_args
+  _preview_llm=$(detect_routing_llm 2>/dev/null || echo "")
+  _preview_llm_args=()
+  [[ -n "$_preview_llm" ]] && _preview_llm_args=(--llm "$_preview_llm")
+
   case "$current_provider" in
     piper)
       # Use the Piper voice manager's list functionality
@@ -468,7 +476,8 @@ provider_preview() {
           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"
+            "$SCRIPT_DIR/play-tts.sh" "Hello, this is the $voice_arg voice. How do you like it?" \
+              "$voice_arg" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
           else
             echo "❌ Voice model not found: $voice_arg"
             echo ""
@@ -506,7 +515,8 @@ provider_preview() {
         local display_name="${voice_entry##*:}"
 
         echo "🔊 ${display_name}..."
-        "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${display_name}" "$voice_name"
+        "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${display_name}" \
+          "$voice_name" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
 
         # Wait for the voice to finish playing before starting next one
         sleep 3
@@ -532,7 +542,8 @@ provider_preview() {
         if say -v ? 2>/dev/null | grep -qi "^${voice_arg} "; then
           echo "🎤 Previewing macOS voice: $voice_arg"
           echo ""
-          "$SCRIPT_DIR/play-tts.sh" "Hello, this is ${voice_arg}. How do you like my voice?" "$voice_arg"
+          "$SCRIPT_DIR/play-tts.sh" "Hello, this is ${voice_arg}. How do you like my voice?" \
+            "$voice_arg" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
         else
           echo "❌ Voice not found: $voice_arg"
           echo ""
@@ -554,7 +565,8 @@ provider_preview() {
       for voice in "${sample_voices[@]}"; do
         if say -v ? 2>/dev/null | grep -qi "^${voice} "; then
           echo "🔊 ${voice}..."
-          "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${voice}" "$voice"
+          "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${voice}" \
+            "$voice" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
           sleep 3
         fi
       done

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

@@ -356,6 +356,44 @@ get_provider_script_path() {
   echo "$provider_script"
 }
 
+# @function detect_routing_llm
+# @intent Detect the LLM name to use for SSH/remote routing in preview and sample commands
+# @why preview/sample call play-tts.sh without --llm, so SSH routing is skipped and audio
+#      plays locally (no sound on headless servers). Detecting the remote LLM and passing
+#      --llm mirrors normal hook behaviour so audio reaches the configured receiver.
+# @returns Echoes LLM name (e.g. "claude-code") or empty string if no remote routing configured
+# @exitcode 0=always
+detect_routing_llm() {
+  # Priority 1: AGENTVIBES_LLM_KEY env var (set during active TTS sessions)
+  if [[ -n "${AGENTVIBES_LLM_KEY:-}" ]] && [[ "$AGENTVIBES_LLM_KEY" =~ ^llm:([a-zA-Z0-9][a-zA-Z0-9_-]*)$ ]]; then
+    echo "${BASH_REMATCH[1]}"
+    return 0
+  fi
+
+  # Priority 2: First mode=remote entry in transport-config.json
+  local _transport_cfg="$HOME/.agentvibes/transport-config.json"
+  if [[ -f "$_transport_cfg" ]] && command -v python3 &>/dev/null; then
+    local _remote_llm
+    _remote_llm=$(AGENTVIBES_CFG="$_transport_cfg" python3 - <<'PYEOF'
+import json, os, sys
+try:
+    d = json.load(open(os.environ['AGENTVIBES_CFG'], encoding='utf-8'))
+    hits = [k for k, v in d.items() if isinstance(v, dict) and v.get('mode') == 'remote']
+    print(hits[0] if hits else '')
+except Exception:
+    print('')
+PYEOF
+)
+    # Validate the key is a safe LLM name before returning
+    if [[ -n "$_remote_llm" ]] && [[ "$_remote_llm" =~ ^[a-zA-Z0-9][a-zA-Z0-9_-]*$ ]]; then
+      echo "$_remote_llm"
+      return 0
+    fi
+  fi
+
+  echo ""
+}
+
 # AI NOTE: This file provides the core abstraction layer for multi-provider TTS.
 # All provider state is managed through simple text files for simplicity and reliability.
 # Project-local configuration takes precedence over global to support per-project providers.

package/.claude/hooks/stop.sh

@@ -32,32 +32,7 @@ fi
 # Only run stop hook in LITE mode
 # (Full mode uses tool calls for TTS, not stop hooks)
 if [[ "$CURRENT_MODE" == "lite" ]]; then
-  # Claude Code sends JSON on stdin: {"transcript_path": "..."}
-  HOOK_INPUT=$(cat)
-  TRANSCRIPT_PATH=$(echo "$HOOK_INPUT" | jq -r '.transcript_path // empty' 2>/dev/null || true)
-
-  [[ -z "$TRANSCRIPT_PATH" ]] && exit 0
-  [[ ! -f "$TRANSCRIPT_PATH" ]] && exit 0
-
-  # Extract Audio Summary ONLY from the most recent assistant response.
-  # Key insight: we must NOT search earlier responses — if the latest response
-  # has no Audio Summary: marker, we stay silent (no stale replay).
-  SUMMARY=$(jq --slurp -r '
-    [.[] | try select(.message.role == "assistant")] | last // null
-    | if . == null then "" else
-        [.message.content[]? | select(.type == "text") | .text] | join("\n")
-      end
-    | if test("[Aa]udio [Ss]ummary:") then . else "" end
-  ' "$TRANSCRIPT_PATH" 2>/dev/null \
-    | sed -n 's/.*[Aa]udio [Ss]ummary:[[:space:]]*\(.*\)/\1/p' \
-    | head -1 \
-    | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-
-  [[ -z "$SUMMARY" ]] && exit 0
-
-  # Speak via AgentVibes play-tts.sh
-  if [[ -f "$PROJECT_ROOT/.claude/hooks/play-tts.sh" ]]; then
-    AGENTVIBES_MIN_TOKENS=3 AGENTVIBES_SHORT_TOKENS=50 \
-      bash "$PROJECT_ROOT/.claude/hooks/play-tts.sh" "$SUMMARY" >/dev/null 2>&1 &
+  if [[ -f "$AGENTVIBES_HOOKS/stop-lite.sh" ]]; then
+    bash "$AGENTVIBES_HOOKS/stop-lite.sh" "$@"
   fi
 fi

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

@@ -561,8 +561,55 @@ case "$1" in
     fi
     ;;
 
+  sample)
+    # Play a sample phrase with the specified voice (used by /agent-vibes:sample)
+    SAMPLE_VOICE="${2:-}"
+    if [[ -z "$SAMPLE_VOICE" ]]; then
+      echo "❌ Usage: /agent-vibes:sample <voice-name>"
+      echo ""
+      echo "Examples:"
+      echo "  /agent-vibes:sample en_US-amy-medium"
+      echo "  /agent-vibes:sample Ryan"
+      exit 1
+    fi
+
+    # Source provider-manager.sh first — get_active_provider and detect_routing_llm
+    # are both defined there; sourcing after calling them silently produces empty values.
+    source "$SCRIPT_DIR/provider-manager.sh" 2>/dev/null || true
+
+    ACTIVE_PROVIDER=$(get_active_provider)
+
+    # Friendly name resolution for Piper and transport providers
+    case "$ACTIVE_PROVIDER" in
+      piper|ssh-remote|agentvibes-receiver|termux-ssh)
+        source "$SCRIPT_DIR/piper-voice-manager.sh" 2>/dev/null || true
+        SAMPLE_META="$(realpath "$SCRIPT_DIR/../../.agentvibes/config/voice-metadata.json" 2>/dev/null || echo "")"
+        if [[ -f "$SAMPLE_META" ]] && command -v jq >/dev/null 2>&1; then
+          SAMPLE_RESOLVED=$(jq -r --arg n "$(to_lower "$SAMPLE_VOICE")" '
+            .voices | to_entries[] |
+            select(.key == $n or (.value.displayName | ascii_downcase) == $n) |
+            .value.id
+          ' "$SAMPLE_META" 2>/dev/null | head -1)
+          if [[ -n "$SAMPLE_RESOLVED" ]] && [[ "$SAMPLE_RESOLVED" =~ ^[a-zA-Z0-9_.:+-]+$ ]]; then
+            echo "🔍 Resolved '${SAMPLE_VOICE}' → '${SAMPLE_RESOLVED}'"
+            SAMPLE_VOICE="$SAMPLE_RESOLVED"
+          fi
+        fi
+        ;;
+    esac
+
+    # Detect routing LLM so SSH-remote setups forward audio to the receiver
+    SAMPLE_LLM=$(detect_routing_llm 2>/dev/null || echo "")
+    SAMPLE_LLM_ARG=()
+    [[ -n "$SAMPLE_LLM" ]] && SAMPLE_LLM_ARG=(--llm "$SAMPLE_LLM")
+
+    echo "🎤 Sampling voice: $SAMPLE_VOICE"
+    "$SCRIPT_DIR/play-tts.sh" "Hi, I'm ${SAMPLE_VOICE}. How does my voice sound?" \
+      "$SAMPLE_VOICE" "${SAMPLE_LLM_ARG[@]+"${SAMPLE_LLM_ARG[@]}"}"
+    ;;
+
   *)
-    echo "Usage: voice-manager.sh [list|switch|get|replay|whoami] [voice_name]"
+    echo "Usage: voice-manager.sh [list|switch|get|replay|whoami|sample] [voice_name]"
     echo ""
     echo "Commands:"
     echo "  list                    - List all available voices"
@@ -570,6 +617,7 @@ case "$1" in
     echo "  get                     - Get current voice name"
     echo "  replay [N]              - Replay Nth most recent audio (default: 1)"
     echo "  whoami                  - Show current voice and personality"
+    echo "  sample <voice_name>     - Play sample audio with the given voice"
     exit 1
     ;;
-esac
+esac

package/.claude/hooks-windows/play-tts.ps1

@@ -22,7 +22,17 @@ param(
     # CLAUDE_PROJECT_DIR value here so per-project config is found even when
     # Bash tool calls do not propagate CLAUDE_PROJECT_DIR to child processes.
     [Parameter(Mandatory = $false)]
-    [string]$ProjectDir = ""
+    [string]$ProjectDir = "",
+
+    # Provider override from the remote sender (set by the watcher from the
+    # JSON payload's "provider" field).  Overrides the local tts-provider.txt
+    # default so the Linux-side config fully controls which engine the Windows
+    # receiver uses — no Windows-side provider config needed.
+    # Per-LLM engine rows in audio-effects.cfg still take final priority for
+    # explicit Windows overrides (e.g. llm:copilot → windows-sapi).
+    # Accepts cross-platform aliases: "piper" = windows-piper, "sapi" = windows-sapi.
+    [Parameter(Mandatory = $false)]
+    [string]$ProviderOverride = ""
 )
 
 # Text-file handoff: the SSH receiver watcher writes long/special-char text to
@@ -99,6 +109,29 @@ switch ($ActiveProvider) {
     }
 }
 
+# Apply remote provider override (from the JSON payload's "provider" field, passed
+# by the SSH-receiver watcher via -ProviderOverride).  This lets the Linux-side
+# audio-effects.cfg row for llm:claude-code specify "piper" and have it honoured
+# on Windows without requiring the Windows tts-provider.txt to be reconfigured.
+# Priority: lower than per-LLM $_LlmEngine (audio-effects.cfg row, set later), higher
+# than the global tts-provider.txt default set above.
+if ($ProviderOverride) {
+    switch ($ProviderOverride) {
+        { $_ -in "windows-piper", "piper" } {
+            $ProviderScript = "$HooksDir\play-tts-piper.ps1"
+            if (-not (Test-Path $ProviderScript)) { $ProviderScript = "$HooksDir\play-tts-windows-piper.ps1" }
+        }
+        { $_ -in "windows-sapi", "sapi" } {
+            $ProviderScript = "$HooksDir\play-tts-sapi.ps1"
+            if (-not (Test-Path $ProviderScript)) { $ProviderScript = "$HooksDir\play-tts-windows-sapi.ps1" }
+        }
+        "soprano" { $ProviderScript = "$HooksDir\play-tts-soprano.ps1" }
+        default {
+            Write-Host "[WARNING] play-tts.ps1: Unknown ProviderOverride '$ProviderOverride' ignored" -ForegroundColor Yellow
+        }
+    }
+}
+
 # Check if provider script exists
 if (-not (Test-Path $ProviderScript)) {
     Write-Host "[ERROR] Provider script not found: $ProviderScript" -ForegroundColor Red