agentvibes 3.2.0 → 3.3.0-alpha.5

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

@@ -0,0 +1,18 @@
+---
+description: Clean up TTS cache files to free up disk space
+scope: user
+---
+
+Execute the AgentVibes cache cleanup script using the Bash tool:
+
+```bash
+.claude/hooks/cleanup-cache.sh
+```
+
+This will:
+- Show current cache size
+- Count all TTS cache files (tts-*.mp3, tts-*.wav, tts-padded-*.mp3, tts-padded-*.wav)
+- Ask for confirmation before deleting
+- Remove all cache files and show space freed
+
+**Note:** The TTS cache can grow to 5GB+ over time. This command safely removes temporary audio files while preserving your background music tracks.

package/.claude/commands/agent-vibes/commands.json

@@ -132,6 +132,10 @@
     {
       "name": "bmad",
       "description": "BMAD voice integration and agent voice assignment"
+    },
+    {
+      "name": "cleanup",
+      "description": "Clean up TTS cache files to free up disk space"
     }
   ]
 }

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

@@ -1,52 +1,52 @@
-# AgentVibes Audio Effects Configuration
+# AgentVibes Audio Effects Configuration|||
 # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME
-#
-# SOX_EFFECTS: sox effect chain (leave empty for none)
-#   - reverb <reverberance> <HF-damping> <room-scale>
-#   - pitch <cents> (100 cents = 1 semitone)
-#   - equalizer <freq> <width>q <gain-dB>
-#   - gain <dB>
-#   - compand <attack,decay> <soft-knee-dB:in-dB,out-dB>
-#
-# BACKGROUND_FILE: path to ambient audio (relative to .claude/audio/tracks/)
-# BACKGROUND_VOLUME: 0.0-1.0 (0.20-0.40 recommended)
-#
+#|||
+# SOX_EFFECTS: sox effect chain (leave empty for none)|||
+#   - reverb <reverberance> <HF-damping> <room-scale>|||
+#   - pitch <cents> (100 cents = 1 semitone)|||
+#   - equalizer <freq> <width>q <gain-dB>|||
+#   - gain <dB>|||
+#   - compand <attack,decay> <soft-knee-dB:in-dB,out-dB>|||
+#|||
+# BACKGROUND_FILE: path to ambient audio (relative to .claude/audio/tracks/)|||
+# BACKGROUND_VOLUME: 0.0-1.0 (0.20-0.40 recommended)|||
+#|||
 # Example: John|reverb 30 50 80|my-track.mp3|0.25
-
-# BMAD Agents - each with unique audio personality
-
-# PM John - upbeat, driving energy
+|||
+# BMAD Agents - each with unique audio personality|||
+|||
+# PM John - upbeat, driving energy|||
 John|gain -1 equalizer 3000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.30
-
-# Architect Winston - deep, authoritative
+|||
+# Architect Winston - deep, authoritative|||
 Winston|reverb 40 50 90 gain -2|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Developer Amelia - clean, precise
+|||
+# Developer Amelia - clean, precise|||
 Amelia|compand 0.3,1 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Business Analyst Mary - warm, analytical
+|||
+# Business Analyst Mary - warm, analytical|||
 Mary|equalizer 200 1q +3 equalizer 2500 1q -2|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Scrum Master Bob - refined, organized
+|||
+# Scrum Master Bob - refined, organized|||
 Bob|reverb 30 40 70 compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Test Architect Murat - crisp, analytical
+|||
+# Test Architect Murat - crisp, analytical|||
 Murat|equalizer 4000 1q +3 compand 0.1,0.3 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# UX Designer Sally - warm, empathetic
+|||
+# UX Designer Sally - warm, empathetic|||
 Sally|reverb 25 40 70 equalizer 300 1q +2|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# Tech Writer Paige - clear, patient
+|||
+# Tech Writer Paige - clear, patient|||
 Paige|compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.20
-
-# Frame Expert Saif - structured, detail-oriented
+|||
+# Frame Expert Saif - structured, detail-oriented|||
 Saif|equalizer 2000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.25
-
-# BMad Master - wise orchestrator
+|||
+# BMad Master - wise orchestrator|||
 BMad Master|reverb 50 60 100 pitch -100|agentvibes_soft_flamenco_loop.mp3|0.30
-
-# Party mode room ambiance - used when multiple agents are talking
+|||
+# Party mode room ambiance - used when multiple agents are talking|||
 _party_mode|compand 0.3,1 6:-70,-60,-20|agent_vibes_dark_chill_step_loop.mp3|0.40
-
-# Default (no agent specified) - clean with Bachata background
-default||agent_vibes_bachata_v1_loop.mp3|0.30
+|||
+# Default (no agent specified) - clean with Bachata background|||
+default|reverb 20 50 50|agent_vibes_ganawa_ambient_v2_loop.mp3|0.30

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

@@ -11,7 +11,7 @@
 # BACKGROUND_FILE: path to ambient audio (relative to .claude/audio/tracks/)
 # BACKGROUND_VOLUME: 0.0-1.0 (0.20-0.40 recommended)
 #
-# Example: John|reverb 30 50 80|my-track.mp3|0.25
+# Example: John|reverb 30 50 80|my-track.mp3|0.10
 
 # BMAD Agents - each with unique audio personality
 
@@ -19,28 +19,28 @@
 John|gain -1 equalizer 3000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.30
 
 # Architect Winston - deep, authoritative
-Winston|reverb 40 50 90 gain -2|agentvibes_soft_flamenco_loop.mp3|0.25
+Winston|reverb 40 50 90 gain -2|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Developer Amelia - clean, precise
-Amelia|compand 0.3,1 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
+Amelia|compand 0.3,1 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Business Analyst Mary - warm, analytical
-Mary|equalizer 200 1q +3 equalizer 2500 1q -2|agentvibes_soft_flamenco_loop.mp3|0.25
+Mary|equalizer 200 1q +3 equalizer 2500 1q -2|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Scrum Master Bob - refined, organized
-Bob|reverb 30 40 70 compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
+Bob|reverb 30 40 70 compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Test Architect Murat - crisp, analytical
-Murat|equalizer 4000 1q +3 compand 0.1,0.3 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.25
+Murat|equalizer 4000 1q +3 compand 0.1,0.3 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # UX Designer Sally - warm, empathetic
-Sally|reverb 25 40 70 equalizer 300 1q +2|agentvibes_soft_flamenco_loop.mp3|0.25
+Sally|reverb 25 40 70 equalizer 300 1q +2|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # Tech Writer Paige - clear, patient
 Paige|compand 0.2,0.5 6:-70,-60,-20|agentvibes_soft_flamenco_loop.mp3|0.20
 
 # Frame Expert Saif - structured, detail-oriented
-Saif|equalizer 2000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.25
+Saif|equalizer 2000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.10
 
 # BMad Master - wise orchestrator
 BMad Master|reverb 50 60 100 pitch -100|agentvibes_soft_flamenco_loop.mp3|0.30

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

@@ -1 +1 @@
-20260127
+20260201

package/.claude/hooks/audio-processor.sh

@@ -305,23 +305,40 @@ main() {
     # Parse config (format: NAME|EFFECTS|BACKGROUND|VOLUME)
     IFS='|' read -r _ sox_effects background_file bg_volume <<< "$config"
 
-    # Temporary files (using explicit paths to avoid unbound variable issues)
-    # Use Termux-compatible temp directory if on Termux, otherwise standard /tmp
+    # SECURITY: Use secure temp directory per CLAUDE.md guidelines
+    # Prefer XDG_RUNTIME_DIR (user-owned, restricted permissions)
+    # Fall back to user-specific directory in /tmp
     local TEMP_DIR
     if [[ -d "/data/data/com.termux" ]]; then
-        # On Termux
-        TEMP_DIR="${TMPDIR:-${PREFIX}/tmp}"
+        # On Termux - use Termux temp
+        TEMP_DIR="${TMPDIR:-${PREFIX:-/data/data/com.termux/files/usr}/tmp}/agentvibes-audio-$$"
+    elif [[ -n "${XDG_RUNTIME_DIR:-}" ]] && [[ -d "$XDG_RUNTIME_DIR" ]]; then
+        # Preferred: XDG_RUNTIME_DIR (user-owned, 700 permissions)
+        TEMP_DIR="$XDG_RUNTIME_DIR/agentvibes-audio"
     else
-        # Standard Linux/macOS
-        TEMP_DIR="${TMPDIR:-/tmp}"
+        # Fallback: user-specific directory in /tmp
+        TEMP_DIR="/tmp/agentvibes-audio-${USER:-$(id -un)}"
     fi
+
+    # Create temp directory with restrictive permissions
+    mkdir -p "$TEMP_DIR"
+    chmod 700 "$TEMP_DIR"
+
+    # SECURITY: Verify ownership of temp directory
+    if [[ "$(stat -c '%u' "$TEMP_DIR" 2>/dev/null || stat -f '%u' "$TEMP_DIR" 2>/dev/null)" != "$(id -u)" ]]; then
+        echo "Error: Temp directory not owned by current user: $TEMP_DIR" >&2
+        exit 1
+    fi
+
+    # SECURITY: Use mktemp for unpredictable filenames
     local temp_effects
     local temp_final
-    temp_effects="$TEMP_DIR/agentvibes-effects-$$.wav"
-    temp_final="$TEMP_DIR/agentvibes-final-$$.wav"
+    temp_effects=$(mktemp "$TEMP_DIR/effects-XXXXXX.wav")
+    temp_final=$(mktemp "$TEMP_DIR/final-XXXXXX.wav")
 
-    # Clean up on exit using explicit paths
-    trap 'rm -f "'"$TEMP_DIR"'/agentvibes-effects-'"$$"'.wav" "'"$TEMP_DIR"'/agentvibes-final-'"$$"'.wav"' EXIT
+    # Clean up on exit - use double quotes to capture paths at definition time
+    # (local variables won't exist at trap execution time outside function scope)
+    trap "rm -f '$temp_effects' '$temp_final'" EXIT
 
     # Step 1: Apply sox effects
     if [[ -n "$sox_effects" ]]; then

package/.claude/hooks/clawdbot-receiver.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/clawdbot-receiver.sh
+#
+# AgentVibes Clawdbot Receiver - SSH-Remote TTS with Agent Support
+# Receives base64-encoded text, voice, and agent name from remote Clawdbot instances
+# Calls AgentVibes play-tts-enhanced.sh to apply agent-specific audio effects
+#
+# Usage (called via SSH from remote):
+#   clawdbot-receiver.sh <base64_text> <voice> <base64_agent_name>
+#
+# Installed at: ~/.termux/agentvibes-play.sh or ~/.agentvibes/play-remote.sh
+#
+# Copyright (c) 2025 Paul Preibisch
+# Licensed under the Apache License, Version 2.0
+#
+
+set -euo pipefail
+
+ENCODED_TEXT="${1:-}"
+VOICE="${2:-en_US-lessac-medium}"
+ENCODED_AGENT="${3:-}"
+
+# Validate inputs
+if [[ -z "$ENCODED_TEXT" ]]; then
+  echo "❌ No encoded text provided" >&2
+  echo "Usage: $0 <base64_text> <voice> <base64_agent_name>" >&2
+  exit 1
+fi
+
+# SECURITY: Decode base64 safely
+# This prevents command injection from malicious text
+DECODED_TEXT=$(echo -n "$ENCODED_TEXT" | base64 -d 2>/dev/null) || {
+  echo "❌ Failed to decode text (invalid base64)" >&2
+  exit 1
+}
+
+DECODED_AGENT="default"
+if [[ -n "$ENCODED_AGENT" ]]; then
+  DECODED_AGENT=$(echo -n "$ENCODED_AGENT" | base64 -d 2>/dev/null) || DECODED_AGENT="default"
+fi
+
+# Find AgentVibes installation
+# Priority: 1. ~/agentvibes, 2. ~/AgentVibes-dev, 3. current directory
+AGENTVIBES_ROOT=""
+if [[ -f "$HOME/agentvibes/.claude/hooks/play-tts-enhanced.sh" ]]; then
+  AGENTVIBES_ROOT="$HOME/agentvibes"
+elif [[ -f "$HOME/AgentVibes-dev/.claude/hooks/play-tts-enhanced.sh" ]]; then
+  AGENTVIBES_ROOT="$HOME/AgentVibes-dev"
+elif [[ -f ".claude/hooks/play-tts-enhanced.sh" ]]; then
+  AGENTVIBES_ROOT="$(pwd)"
+else
+  echo "❌ AgentVibes not found" >&2
+  echo "💡 Install AgentVibes at ~/agentvibes/ or ~/AgentVibes-dev/" >&2
+  exit 1
+fi
+
+echo "🎤 Agent: $DECODED_AGENT | Voice: $VOICE" >&2
+
+# Call AgentVibes play-tts-enhanced.sh with agent name for audio-effects.cfg lookup
+cd "$AGENTVIBES_ROOT" && \
+  bash .claude/hooks/play-tts-enhanced.sh "$DECODED_TEXT" "$DECODED_AGENT" "$VOICE" 2>&1 || {
+  # Fallback to standard play-tts if enhanced fails
+  echo "⚠️  Enhanced TTS failed, using standard TTS" >&2
+  bash .claude/hooks/play-tts.sh "$DECODED_TEXT" "$VOICE" 2>&1
+}
+
+exit 0

package/.claude/hooks/cleanup-cache.sh

@@ -0,0 +1,106 @@
+#!/usr/bin/env bash
+# AgentVibes Cache Cleanup Script
+# Removes TTS cache files to free up disk space
+
+set -euo pipefail
+
+# Get the project root directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+AUDIO_DIR="$PROJECT_ROOT/.claude/audio"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}🧹 AgentVibes Cache Cleanup${NC}"
+echo ""
+
+# Check if audio directory exists
+if [[ ! -d "$AUDIO_DIR" ]]; then
+  echo -e "${YELLOW}No cache directory found at: $AUDIO_DIR${NC}"
+  exit 0
+fi
+
+# Calculate current cache size
+echo "Calculating cache size..."
+CACHE_SIZE=$(du -sh "$AUDIO_DIR" 2>/dev/null | cut -f1 || echo "unknown")
+echo -e "${BLUE}Current cache size: ${YELLOW}$CACHE_SIZE${NC}"
+echo ""
+
+# Count files to be deleted
+TTS_MP3_COUNT=$(find "$AUDIO_DIR" -maxdepth 1 -name "tts-*.mp3" -type f 2>/dev/null | wc -l)
+TTS_WAV_COUNT=$(find "$AUDIO_DIR" -maxdepth 1 -name "tts-*.wav" -type f 2>/dev/null | wc -l)
+TTS_PADDED_MP3_COUNT=$(find "$AUDIO_DIR" -maxdepth 1 -name "tts-padded-*.mp3" -type f 2>/dev/null | wc -l)
+TTS_PADDED_WAV_COUNT=$(find "$AUDIO_DIR" -maxdepth 1 -name "tts-padded-*.wav" -type f 2>/dev/null | wc -l)
+BMAD_RECORDINGS_COUNT=0
+if [[ -d "$AUDIO_DIR/bmad-party-mode-recordings" ]]; then
+  BMAD_RECORDINGS_COUNT=$(find "$AUDIO_DIR/bmad-party-mode-recordings" -type f 2>/dev/null | wc -l)
+fi
+
+TOTAL_FILES=$((TTS_MP3_COUNT + TTS_WAV_COUNT + TTS_PADDED_MP3_COUNT + TTS_PADDED_WAV_COUNT + BMAD_RECORDINGS_COUNT))
+
+if [[ $TOTAL_FILES -eq 0 ]]; then
+  echo -e "${GREEN}✓ Cache is already clean! No TTS cache files found.${NC}"
+  exit 0
+fi
+
+echo -e "Found ${YELLOW}$TOTAL_FILES${NC} cache files:"
+echo -e "  • TTS MP3 files: $TTS_MP3_COUNT"
+echo -e "  • TTS WAV files: $TTS_WAV_COUNT"
+echo -e "  • TTS padded MP3 files: $TTS_PADDED_MP3_COUNT"
+echo -e "  • TTS padded WAV files: $TTS_PADDED_WAV_COUNT"
+echo -e "  • BMAD party mode recordings: $BMAD_RECORDINGS_COUNT"
+echo ""
+
+# Ask for confirmation
+read -p "Delete all cache files? (y/N): " -n 1 -r
+echo
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+  echo -e "${YELLOW}Cleanup cancelled.${NC}"
+  exit 0
+fi
+
+echo ""
+echo "Deleting cache files..."
+
+# Delete TTS cache files
+DELETED=0
+
+if [[ $TTS_MP3_COUNT -gt 0 ]]; then
+  find "$AUDIO_DIR" -maxdepth 1 -name "tts-*.mp3" -type f -delete
+  DELETED=$((DELETED + TTS_MP3_COUNT))
+fi
+
+if [[ $TTS_WAV_COUNT -gt 0 ]]; then
+  find "$AUDIO_DIR" -maxdepth 1 -name "tts-*.wav" -type f -delete
+  DELETED=$((DELETED + TTS_WAV_COUNT))
+fi
+
+if [[ $TTS_PADDED_MP3_COUNT -gt 0 ]]; then
+  find "$AUDIO_DIR" -maxdepth 1 -name "tts-padded-*.mp3" -type f -delete
+  DELETED=$((DELETED + TTS_PADDED_MP3_COUNT))
+fi
+
+if [[ $TTS_PADDED_WAV_COUNT -gt 0 ]]; then
+  find "$AUDIO_DIR" -maxdepth 1 -name "tts-padded-*.wav" -type f -delete
+  DELETED=$((DELETED + TTS_PADDED_WAV_COUNT))
+fi
+
+if [[ $BMAD_RECORDINGS_COUNT -gt 0 ]]; then
+  rm -rf "$AUDIO_DIR/bmad-party-mode-recordings"
+  DELETED=$((DELETED + BMAD_RECORDINGS_COUNT))
+fi
+
+# Calculate new size
+NEW_SIZE=$(du -sh "$AUDIO_DIR" 2>/dev/null | cut -f1 || echo "unknown")
+
+echo ""
+echo -e "${GREEN}✓ Cleanup complete!${NC}"
+echo -e "  • Deleted: ${GREEN}$DELETED${NC} files"
+echo -e "  • Old size: ${YELLOW}$CACHE_SIZE${NC}"
+echo -e "  • New size: ${GREEN}$NEW_SIZE${NC}"
+echo ""

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

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/play-tts-ssh-remote.sh
+#
+# AgentVibes - SSH-Remote TTS Provider
+# Sends text to remote device via SSH for local AgentVibes playback
+#
+# Copyright (c) 2025 Paul Preibisch
+# Licensed under the Apache License, Version 2.0
+#
+
+set -euo pipefail
+
+TEXT="${1:-}"
+VOICE="${2:-en_US-lessac-medium}"
+AGENT_NAME="${3:-default}"
+
+# Validate required input
+if [[ -z "$TEXT" ]]; then
+  echo "❌ No text provided" >&2
+  echo "Usage: $0 <text> [voice] [agent_name]" >&2
+  exit 1
+fi
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Get SSH host from config
+SSH_HOST=$(cat "$PROJECT_ROOT/.claude/ssh-remote-host.txt" 2>/dev/null || \
+           cat "$HOME/.claude/ssh-remote-host.txt" 2>/dev/null || echo "")
+
+if [[ -z "$SSH_HOST" ]]; then
+  echo "❌ SSH-Remote host not configured" >&2
+  echo "💡 Set host: echo 'android' > ~/.claude/ssh-remote-host.txt" >&2
+  exit 1
+fi
+
+# SECURITY: Validate SSH_HOST to prevent option injection
+# Must be a valid hostname, IP address, or SSH config alias (alphanumeric, dots, hyphens, underscores)
+if [[ ! "$SSH_HOST" =~ ^[a-zA-Z0-9][a-zA-Z0-9._-]*$ ]]; then
+  echo "❌ Invalid SSH host format: $SSH_HOST" >&2
+  echo "💡 Host must be alphanumeric (may contain dots, hyphens, underscores)" >&2
+  exit 1
+fi
+
+# SECURITY: Reject hosts starting with hyphen (SSH option injection)
+if [[ "$SSH_HOST" == -* ]]; then
+  echo "❌ Invalid SSH host: cannot start with hyphen" >&2
+  exit 1
+fi
+
+# SECURITY: Validate VOICE to prevent injection (alphanumeric, hyphens, underscores only)
+if [[ ! "$VOICE" =~ ^[a-zA-Z0-9_-]+$ ]]; then
+  echo "❌ Invalid voice format: $VOICE" >&2
+  exit 1
+fi
+
+# SECURITY: Validate AGENT_NAME to prevent injection (alphanumeric, hyphens, underscores, spaces only)
+if [[ ! "$AGENT_NAME" =~ ^[a-zA-Z0-9_\ -]+$ ]]; then
+  echo "❌ Invalid agent name format: $AGENT_NAME" >&2
+  exit 1
+fi
+
+# SECURITY: Encode text and agent name as base64 to prevent command injection
+# The receiver will decode these safely
+ENCODED_TEXT=$(printf '%s' "$TEXT" | base64 -w 0)
+ENCODED_AGENT=$(printf '%s' "$AGENT_NAME" | base64 -w 0)
+
+# Send text to remote for local AgentVibes playback
+echo "📱 Sending to $SSH_HOST for local playback..." >&2
+
+# Determine which receiver script exists and send encoded text, voice, and agent name
+# SECURITY: Base64-encoded values are safe to pass as arguments (no shell metacharacters)
+# The receiver auto-detects and decodes base64 input
+if ssh "$SSH_HOST" "test -f ~/.termux/agentvibes-play.sh" 2>/dev/null; then
+  ssh "$SSH_HOST" "bash ~/.termux/agentvibes-play.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'" &
+  SSH_PID=$!
+elif ssh "$SSH_HOST" "test -f ~/.agentvibes/play-remote.sh" 2>/dev/null; then
+  ssh "$SSH_HOST" "bash ~/.agentvibes/play-remote.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'" &
+  SSH_PID=$!
+else
+  echo "⚠️  Receiver script not found on $SSH_HOST" >&2
+  echo "💡 Install: agentvibes install --ssh-receiver" >&2
+  exit 1
+fi
+
+# Log the background PID for debugging (non-blocking)
+echo "✓ Sent to $SSH_HOST (PID: $SSH_PID, playing remotely)" >&2
+exit 0

package/.claude/hooks/termux-installer.sh

@@ -205,6 +205,43 @@ if [[ ! -f "$CLAUDE_DIR/tts-provider.txt" ]]; then
     echo -e "  ${GREEN}✓${NC} TTS provider set to piper"
 fi
 
+echo ""
+
+# Step 7: Install Clawdbot SSH receiver
+echo -e "${BLUE}[7/7] Installing Clawdbot SSH receiver...${NC}"
+
+TERMUX_DIR="$HOME/.termux"
+mkdir -p "$TERMUX_DIR"
+
+# Create wrapper script at ~/.termux/agentvibes-play.sh
+# This calls the main receiver in AgentVibes hooks
+cat > "$TERMUX_DIR/agentvibes-play.sh" << 'EOF'
+#!/usr/bin/env bash
+# AgentVibes Clawdbot Receiver Wrapper
+# Installed by AgentVibes Termux installer
+# Forwards to main receiver script in AgentVibes
+
+# Find AgentVibes installation
+if [[ -f "$HOME/agentvibes/.claude/hooks/clawdbot-receiver.sh" ]]; then
+  exec bash "$HOME/agentvibes/.claude/hooks/clawdbot-receiver.sh" "$@"
+elif [[ -f "$HOME/AgentVibes-dev/.claude/hooks/clawdbot-receiver.sh" ]]; then
+  exec bash "$HOME/AgentVibes-dev/.claude/hooks/clawdbot-receiver.sh" "$@"
+else
+  echo "❌ AgentVibes clawdbot-receiver.sh not found" >&2
+  exit 1
+fi
+EOF
+
+chmod +x "$TERMUX_DIR/agentvibes-play.sh"
+echo -e "  ${GREEN}✓${NC} Clawdbot receiver installed at ~/.termux/agentvibes-play.sh"
+
+# Also create fallback at ~/.agentvibes/play-remote.sh
+AGENTVIBES_DIR="$HOME/.agentvibes"
+mkdir -p "$AGENTVIBES_DIR"
+ln -sf "$TERMUX_DIR/agentvibes-play.sh" "$AGENTVIBES_DIR/play-remote.sh" 2>/dev/null || \
+  cp "$TERMUX_DIR/agentvibes-play.sh" "$AGENTVIBES_DIR/play-remote.sh"
+echo -e "  ${GREEN}✓${NC} Fallback link created at ~/.agentvibes/play-remote.sh"
+
 echo ""
 echo -e "${GREEN}════════════════════════════════════════════════════════════${NC}"
 echo -e "${GREEN}  Installation Complete!${NC}"

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "3.2.0",
+  "version": "3.3.0-alpha.5",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code, Claude Desktop (via MCP), and Clawdbot with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [
@@ -27,15 +27,17 @@
   "type": "module",
   "main": "src/installer.js",
   "bin": {
-    "agentvibes": "./bin/agent-vibes",
-    "agent-vibes": "./bin/agent-vibes",
-    "agentvibes-mcp-server": "./bin/mcp-server.js",
-    "test-bmad-pr": "./bin/test-bmad-pr"
+    "agentvibes": "bin/agent-vibes",
+    "agent-vibes": "bin/agent-vibes",
+    "agentvibes-mcp-server": "bin/mcp-server.js",
+    "test-bmad-pr": "bin/test-bmad-pr"
   },
   "files": [
     "bin/",
     "src/",
-    "templates/",
+    "templates/*.sh",
+    "templates/*.md",
+    "templates/audio/*.mp3",
     "mcp-server/*.py",
     "mcp-server/*.js",
     "mcp-server/*.md",
@@ -44,7 +46,9 @@
     "mcp-server/*.json",
     "mcp-server/docs/",
     "mcp-server/examples/",
-    ".claude/commands/",
+    ".claude/commands/agent-vibes/",
+    ".claude/commands/agent-vibes-bmad-voices.md",
+    ".claude/commands/agent-vibes-rdp.md",
     ".claude/hooks/",
     ".claude/personalities/",
     ".claude/output-styles/",
@@ -57,7 +61,6 @@
     ".claude/piper-voices-dir.txt",
     ".claude/verbosity.txt",
     ".claude/github-star-reminder.txt",
-    ".bmad/",
     ".clawdbot/",
     ".mcp.json",
     "README.md",