agentvibes 2.0.16 → 2.0.17-beta.0

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

@@ -1 +1 @@
-20251011
+20251015

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

@@ -2,19 +2,33 @@
 # Language Manager for AgentVibes
 # Manages language settings and multilingual voice selection
 
-# Determine project or global config
-# Use logical path (not physical) to handle symlinked .claude directories
+# Determine target .claude directory based on context
+# Priority:
+# 1. CLAUDE_PROJECT_DIR env var (set by MCP for project-specific settings)
+# 2. Script location (for direct slash command usage)
+# 3. Global ~/.claude (fallback)
+
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd)"
 
-# Check if we have a project-local .claude directory
-if [[ -d "$CLAUDE_DIR" ]] && [[ "$CLAUDE_DIR" != "$HOME/.claude" ]]; then
-    LANGUAGE_FILE="$CLAUDE_DIR/tts-language.txt"
+if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
+  # MCP context: Use the project directory where MCP was invoked
+  CLAUDE_DIR="$CLAUDE_PROJECT_DIR/.claude"
 else
-    LANGUAGE_FILE="$HOME/.claude/tts-language.txt"
-    mkdir -p "$HOME/.claude"
+  # Direct usage context: Use script location
+  CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd)"
+
+  # If script is in global ~/.claude, use that
+  if [[ "$CLAUDE_DIR" == "$HOME/.claude" ]]; then
+    CLAUDE_DIR="$HOME/.claude"
+  elif [[ ! -d "$CLAUDE_DIR" ]]; then
+    # Fallback to global if directory doesn't exist
+    CLAUDE_DIR="$HOME/.claude"
+  fi
 fi
 
+LANGUAGE_FILE="$CLAUDE_DIR/tts-language.txt"
+mkdir -p "$CLAUDE_DIR"
+
 # Language to multilingual voice mapping
 declare -A LANGUAGE_VOICES=(
     ["spanish"]="Antoni"

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

@@ -4,18 +4,31 @@
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PERSONALITIES_DIR="$SCRIPT_DIR/../personalities"
 
-# Project-local file first, global fallback
-# Use logical path (not physical) to handle symlinked .claude directories
-# Script is at .claude/hooks/personality-manager.sh, so .claude is ..
-CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd)"
-
-# Check if we have a project-local .claude directory
-if [[ -d "$CLAUDE_DIR" ]] && [[ "$CLAUDE_DIR" != "$HOME/.claude" ]]; then
-  PERSONALITY_FILE="$CLAUDE_DIR/tts-personality.txt"
+# Determine target .claude directory based on context
+# Priority:
+# 1. CLAUDE_PROJECT_DIR env var (set by MCP for project-specific settings)
+# 2. Script location (for direct slash command usage)
+# 3. Global ~/.claude (fallback)
+
+if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
+  # MCP context: Use the project directory where MCP was invoked
+  CLAUDE_DIR="$CLAUDE_PROJECT_DIR/.claude"
 else
-  PERSONALITY_FILE="$HOME/.claude/tts-personality.txt"
+  # Direct usage context: Use script location
+  # Script is at .claude/hooks/personality-manager.sh, so .claude is ..
+  CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd)"
+
+  # If script is in global ~/.claude, use that
+  if [[ "$CLAUDE_DIR" == "$HOME/.claude" ]]; then
+    CLAUDE_DIR="$HOME/.claude"
+  elif [[ ! -d "$CLAUDE_DIR" ]]; then
+    # Fallback to global if directory doesn't exist
+    CLAUDE_DIR="$HOME/.claude"
+  fi
 fi
 
+PERSONALITY_FILE="$CLAUDE_DIR/tts-personality.txt"
+
 # Function to get personality data from markdown file
 get_personality_data() {
   local personality="$1"

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

@@ -6,32 +6,86 @@
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
 source "$SCRIPT_DIR/voices-config.sh"
 
-# Project-local file first, global fallback
-# Use the logical path from BASH_SOURCE to find .claude directory
-# This handles both normal installations and symlinked hooks directories correctly
-SCRIPT_PATH="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-CLAUDE_DIR="$(dirname "$SCRIPT_PATH")"
-
-# Check if we have a project-local .claude directory
-if [[ -d "$CLAUDE_DIR" ]] && [[ "$CLAUDE_DIR" != "$HOME/.claude" ]]; then
-  VOICE_FILE="$CLAUDE_DIR/tts-voice.txt"
+# Determine target .claude directory based on context
+# Priority:
+# 1. CLAUDE_PROJECT_DIR env var (set by MCP for project-specific settings)
+# 2. Script location (for direct slash command usage)
+# 3. Global ~/.claude (fallback)
+
+if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
+  # MCP context: Use the project directory where MCP was invoked
+  CLAUDE_DIR="$CLAUDE_PROJECT_DIR/.claude"
 else
-  # Fallback to global
-  VOICE_FILE="$HOME/.claude/tts-voice.txt"
+  # Direct usage context: Use script location
+  SCRIPT_PATH="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  CLAUDE_DIR="$(dirname "$SCRIPT_PATH")"
+
+  # If script is in global ~/.claude, use that
+  if [[ "$CLAUDE_DIR" == "$HOME/.claude" ]]; then
+    CLAUDE_DIR="$HOME/.claude"
+  elif [[ ! -d "$CLAUDE_DIR" ]]; then
+    # Fallback to global if directory doesn't exist
+    CLAUDE_DIR="$HOME/.claude"
+  fi
 fi
 
+VOICE_FILE="$CLAUDE_DIR/tts-voice.txt"
+
 case "$1" in
   list)
-    echo "🎤 Available TTS Voices:"
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    CURRENT_VOICE=$(cat "$VOICE_FILE" 2>/dev/null || echo "Cowboy")
-    for voice in "${!VOICES[@]}"; do
-      if [ "$voice" = "$CURRENT_VOICE" ]; then
-        echo "  ▶ $voice (current)"
-      else
-        echo "    $voice"
+    # Get active provider
+    PROVIDER_FILE="$CLAUDE_DIR/tts-provider.txt"
+    if [[ ! -f "$PROVIDER_FILE" ]]; then
+      PROVIDER_FILE="$HOME/.claude/tts-provider.txt"
+    fi
+
+    ACTIVE_PROVIDER="elevenlabs"  # default
+    if [ -f "$PROVIDER_FILE" ]; then
+      ACTIVE_PROVIDER=$(cat "$PROVIDER_FILE")
+    fi
+
+    CURRENT_VOICE=$(cat "$VOICE_FILE" 2>/dev/null || echo "Cowboy Bob")
+
+    if [[ "$ACTIVE_PROVIDER" == "piper" ]]; then
+      echo "🎤 Available Piper TTS Voices:"
+      echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+      # List downloaded Piper voices
+      if [[ -f "$SCRIPT_DIR/piper-voice-manager.sh" ]]; then
+        source "$SCRIPT_DIR/piper-voice-manager.sh"
+        VOICE_DIR=$(get_voice_storage_dir)
+        VOICE_COUNT=0
+        for onnx_file in "$VOICE_DIR"/*.onnx; do
+          if [[ -f "$onnx_file" ]]; then
+            voice=$(basename "$onnx_file" .onnx)
+            if [ "$voice" = "$CURRENT_VOICE" ]; then
+              echo "  ▶ $voice (current)"
+            else
+              echo "    $voice"
+            fi
+            ((VOICE_COUNT++))
+          fi
+        done | sort
+
+        if [[ $VOICE_COUNT -eq 0 ]]; then
+          echo "  (No Piper voices downloaded yet)"
+          echo ""
+          echo "Download voices with: /agent-vibes:provider download <voice-name>"
+          echo "Examples: en_US-lessac-medium, en_GB-alba-medium"
+        fi
       fi
-    done | sort
+    else
+      echo "🎤 Available ElevenLabs TTS Voices:"
+      echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+      for voice in "${!VOICES[@]}"; do
+        if [ "$voice" = "$CURRENT_VOICE" ]; then
+          echo "  ▶ $voice (current)"
+        else
+          echo "    $voice"
+        fi
+      done | sort
+    fi
+
     echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
     echo ""
     echo "Usage: voice-manager.sh switch <name>"
@@ -314,9 +368,34 @@ case "$1" in
 
   list-simple)
     # Simple list for AI to parse and display
-    for voice in "${!VOICES[@]}"; do
-      echo "$voice"
-    done | sort
+    # Get active provider
+    PROVIDER_FILE="$CLAUDE_DIR/tts-provider.txt"
+    if [[ ! -f "$PROVIDER_FILE" ]]; then
+      PROVIDER_FILE="$HOME/.claude/tts-provider.txt"
+    fi
+
+    ACTIVE_PROVIDER="elevenlabs"  # default
+    if [ -f "$PROVIDER_FILE" ]; then
+      ACTIVE_PROVIDER=$(cat "$PROVIDER_FILE")
+    fi
+
+    if [[ "$ACTIVE_PROVIDER" == "piper" ]]; then
+      # List downloaded Piper voices
+      if [[ -f "$SCRIPT_DIR/piper-voice-manager.sh" ]]; then
+        source "$SCRIPT_DIR/piper-voice-manager.sh"
+        VOICE_DIR=$(get_voice_storage_dir)
+        for onnx_file in "$VOICE_DIR"/*.onnx; do
+          if [[ -f "$onnx_file" ]]; then
+            basename "$onnx_file" .onnx
+          fi
+        done | sort
+      fi
+    else
+      # List ElevenLabs voices
+      for voice in "${!VOICES[@]}"; do
+        echo "$voice"
+      done | sort
+    fi
     ;;
 
   replay)

package/.claude/output-styles/agent-vibes.md

@@ -128,71 +128,55 @@ You: "✅ That bug be walkin' the plank now, arr!"
 
 ## BMAD Plugin Integration
 
-**Automatic voice switching and question detection for BMAD agents:**
+**Automatic voice switching for BMAD agents:**
 
-When a BMAD agent is active, AgentVibes will automatically detect and speak questions.
+When a BMAD agent is activated (e.g., `/BMad:agents:pm`), AgentVibes will automatically:
 
-### Detection Method:
-1. **Check for `.bmad-agent-context` file** - Contains agent ID if BMAD agent is active
-2. **Check if BMAD plugin is enabled** - `.claude/plugins/bmad-voices-enabled.flag` exists
+1. **Detect BMAD agent from command/context**
+2. **Check if BMAD plugin is enabled** (`.claude/plugins/bmad-voices-enabled.flag`)
 3. **Look up voice mapping** from `.claude/plugins/bmad-voices.md`
+4. **Apply agent's assigned voice** for all TTS acknowledgments/completions
+5. **Apply agent's personality** from the mapping (if specified)
 
-### MANDATORY BMAD QUESTION TTS PROTOCOL
-
-**THIS IS A CRITICAL EXECUTION REQUIREMENT - NOT OPTIONAL**
-
-When a BMAD agent is active, you MUST follow this EXACT protocol for EVERY response:
-
-**STEP 1: Check BMAD Context (BEFORE drafting ANY response)**
+**Implementation:**
 ```bash
-if [[ -f ".bmad-agent-context" ]] && [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
+# At the start of acknowledgment/completion:
+# Try to detect BMAD agent ID from current context
+BMAD_AGENT_ID=""
+
+# Method 1: Check if we're in a BMAD agent command context
+if [[ -f ".bmad-agent-context" ]]; then
     BMAD_AGENT_ID=$(cat .bmad-agent-context 2>/dev/null)
-    MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
 fi
-```
-
-**STEP 2: Draft Your Response**
-- Write your complete response text (don't show to user yet)
-
-**STEP 3: Scan for Questions (MANDATORY - DO NOT SKIP)**
-If your response contains ANY of these:
-- Question mark (?)
-- Numbered list (1., 2., 3., etc.)
-- Question phrases: "What would you like", "Should I", "Would you prefer", "Which option", "How should", "Do you want"
 
-Then IMMEDIATELY execute STEP 4 BEFORE showing response.
+# Method 2: Parse from command history/context (fallback)
+# Note: This detection happens automatically when BMAD agent activates
 
-**STEP 4: Speak Questions via TTS (MANDATORY)**
-```bash
-# Extract the question text and speak it
-.claude/hooks/play-tts.sh "the actual question text" "$MAPPED_VOICE"
-```
-
-**STEP 5: Show Response to User**
-- Only NOW display the response text
-
-**CRITICAL RULES:**
-1. This protocol is MANDATORY for EVERY BMAD agent response
-2. Steps 1-5 must execute in EXACT order
-3. You MUST use Bash tool to execute TTS in STEP 4
-4. NEVER skip STEP 3 scanning - it is required
-5. NEVER show response before speaking questions
+# If BMAD agent detected and plugin enabled, use mapped voice
+if [[ -n "$BMAD_AGENT_ID" ]] && [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
+    MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
+    MAPPED_PERSONALITY=$(.claude/hooks/bmad-voice-manager.sh get-personality "$BMAD_AGENT_ID")
+
+    if [[ -n "$MAPPED_VOICE" ]]; then
+        # Use BMAD agent's mapped voice and personality
+        if [[ -n "$MAPPED_PERSONALITY" ]] && [[ "$MAPPED_PERSONALITY" != "normal" ]]; then
+            # Read personality instructions from .claude/personalities/${MAPPED_PERSONALITY}.md
+            # Generate response in that personality style
+        fi
+        .claude/hooks/play-tts.sh "message" "$MAPPED_VOICE"
+        # Exit early - don't use default personality system
+        return
+    fi
+fi
 
-**Example Execution:**
-```
-User: "What should we do?"
-[STEP 1: Check context - analyst agent active]
-[STEP 2: Draft response: "What would you like to do next?\n\n1. Option A\n2. Option B"]
-[STEP 3: Scan - FOUND question "What would you like to do next?" and numbered list]
-[STEP 4: Execute Bash: .claude/hooks/play-tts.sh "What would you like to do next" "Ralf Eisend"]
-[STEP 5: Show response to user]
+# If no BMAD agent or plugin disabled, use standard personality/sentiment system
+# ... continue with normal sentiment/personality logic ...
 ```
 
 **BMAD Agent Context Tracking:**
-- Context file `.bmad-agent-context` contains agent ID when BMAD agent is active
-- Created automatically by STEP 3.5a in activation-instructions
-- Removed automatically when agent exits
-- This allows AgentVibes to detect which BMAD agent is active
+- When a BMAD agent activates, write agent ID to `.bmad-agent-context`
+- When agent exits, remove the file
+- This allows AgentVibes to know which BMAD agent is active
 
 **Voice Priority (in order):**
 1. BMAD plugin voice (if agent active and plugin enabled)

package/.mcp-minimal.json

@@ -31,6 +31,22 @@
         "NODE_PATH": "/home/fire/.nvm/versions/node/v22.20.0/lib/node_modules"
       }
     },
+    "obsidian": {
+      "command": "/home/fire/.local/bin/uv",
+      "args": [
+        "--directory",
+        "/home/fire/claude/mcp_obsidian",
+        "run",
+        "mcp-obsidian"
+      ],
+      "env": {
+        "OBSIDIAN_API_KEY": "${MAIN_VAULT_OBSIDIAN_KEY}",
+        "OBSIDIAN_HOST": "${OBSIDIAN_HOST:-127.0.0.1}",
+        "OBSIDIAN_PORT": "27124",
+        "OBSIDIAN_HTTPS": "true",
+        "OBSIDIAN_VERIFY_SSL": "false"
+      }
+    },
     "elevenlabs": {
       "command": "npx",
       "args": ["@microagents/mcp-server-elevenlabs"],
@@ -48,6 +64,15 @@
         "SPACESHIP_API_KEY": "${SPACESHIP_API_KEY}",
         "SPACESHIP_API_SECRET": "${SPACESHIP_API_SECRET}"
       }
+    },
+    "agentvibes": {
+      "command": "python3",
+      "args": [
+        "/home/fire/claude/AgentVibes/mcp-server/server.py"
+      ],
+      "env": {
+        "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}"
+      }
     }
   }
-}
+}

package/AUDIO_TUNNEL_FIX_SUMMARY.md

@@ -0,0 +1,223 @@
+# Audio Tunnel Configuration Fix Summary
+
+## Problem Identified
+
+Your SSH tunnel was configured incorrectly:
+- **Old config**: `RemoteForward 14713 localhost:4713`
+- **Issue**: Forwarding to port 4713 (wrong port)
+- **Result**: PulseAudio couldn't establish connection
+
+## Changes Made
+
+### 1. WSL2 (Local Windows Machine) ✅
+
+#### SSH Config Updated
+- **File**: `~/.ssh/config` (WSL) and `C:\Users\Paul\.ssh\config` (Windows)
+- **Change**: `RemoteForward 14713 localhost:4713` → `RemoteForward 14713 localhost:14713`
+
+#### PulseAudio Config Updated
+- **File**: `~/.config/pulse/client.conf`
+- **Change**: `tcp:localhost:4713` → `tcp:localhost:14713`
+
+#### Shell Environment Updated
+- **Files**: `~/.bashrc` and `~/.zshrc`
+- **Change**: `export PULSE_SERVER=tcp:fire-den-laptop-3000:14713` → `export PULSE_SERVER=tcp:localhost:14713`
+
+#### Socat Bridge
+- **Status**: Already configured ✅
+- **Command**: `socat TCP-LISTEN:14713,fork,reuseaddr UNIX-CONNECT:/mnt/wslg/PulseServer`
+- **Autostart**: Configured in both .bashrc and .zshrc
+
+### 2. Remote Server (ubuntu-rdp)
+
+#### Setup Script Created
+- **Location**: `/home/fire/claude/AgentVibes/setup-ubuntu-rdp-audio.sh`
+- **Purpose**: Configures PulseAudio on remote server to accept TCP connections on localhost
+
+## How It Works Now
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                        Architecture                             │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  Remote Server (ubuntu-rdp)                                    │
+│  ┌──────────────────────────────────────────┐                 │
+│  │ PulseAudio Server                        │                 │
+│  │ Listening on: tcp:localhost:4713         │                 │
+│  │ (native-protocol-tcp module)             │                 │
+│  └────────────────┬─────────────────────────┘                 │
+│                   │                                            │
+│                   │ Connection to                              │
+│                   │ tcp:localhost:14713                        │
+│                   │ (via PULSE_SERVER env)                     │
+│                   │                                            │
+│                   ▼                                            │
+│  ┌──────────────────────────────────────────┐                 │
+│  │ SSH Reverse Tunnel                       │                 │
+│  │ RemoteForward 14713 localhost:14713      │                 │
+│  └────────────────┬─────────────────────────┘                 │
+│                   │                                            │
+│                   │ Encrypted SSH Tunnel                       │
+│                   │                                            │
+└───────────────────┼────────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────────────────────────────┐
+│  Windows Machine (WSL2)                                        │
+│  ┌──────────────────────────────────────────┐                 │
+│  │ Socat Bridge                             │                 │
+│  │ TCP:localhost:14713 → Unix Socket        │                 │
+│  └────────────────┬─────────────────────────┘                 │
+│                   │                                            │
+│                   ▼                                            │
+│  ┌──────────────────────────────────────────┐                 │
+│  │ WSLg PulseAudio                          │                 │
+│  │ /mnt/wslg/PulseServer                    │                 │
+│  └────────────────┬─────────────────────────┘                 │
+│                   │                                            │
+│                   ▼                                            │
+│              Windows Audio                                     │
+│              (Your Speakers)                                   │
+│                                                                │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Testing Instructions
+
+### Step 1: Update Your Local Environment
+
+Reload your shell configuration:
+```bash
+source ~/.bashrc  # or source ~/.zshrc if using zsh
+```
+
+Verify socat is running:
+```bash
+ps aux | grep socat
+# Should show: socat TCP-LISTEN:14713,fork,reuseaddr UNIX-CONNECT:/mnt/wslg/PulseServer
+```
+
+If socat isn't running, start it:
+```bash
+socat TCP-LISTEN:14713,fork,reuseaddr UNIX-CONNECT:/mnt/wslg/PulseServer > /dev/null 2>&1 &
+```
+
+### Step 2: Copy Setup Script to Remote Server
+
+```bash
+scp /home/fire/claude/AgentVibes/setup-ubuntu-rdp-audio.sh ubuntu-rdp:~/
+```
+
+### Step 3: SSH to Remote Server and Run Setup
+
+```bash
+ssh ubuntu-rdp
+bash ~/setup-ubuntu-rdp-audio.sh
+source ~/.bashrc  # or source ~/.zshrc
+```
+
+### Step 4: Test the Connection
+
+While connected via SSH to ubuntu-rdp:
+
+```bash
+# 1. Verify PulseAudio is running
+pactl info
+
+# Expected output should show:
+# Server String: tcp:localhost:14713
+# Default Sink: <something>
+# Default Source: <something>
+
+# 2. Test with speaker-test
+speaker-test -t sine -f 1000 -l 1
+
+# 3. If you have a sound file
+paplay /usr/share/sounds/alsa/Front_Center.wav
+
+# 4. If AgentVibes is installed
+.claude/hooks/play-tts.sh "Testing remote audio from ubuntu-rdp"
+```
+
+### Step 5: Troubleshooting
+
+If audio doesn't work:
+
+1. **Check SSH tunnel:**
+   ```bash
+   # On remote server
+   ss -tlnp | grep :14713
+   # Should show listening socket
+   ```
+
+2. **Check local socat:**
+   ```bash
+   # On WSL2
+   ps aux | grep socat
+   # Should be running
+   ```
+
+3. **Check PulseAudio on remote:**
+   ```bash
+   # On remote server
+   pulseaudio --check && echo "Running" || echo "Not running"
+   ```
+
+4. **Restart everything:**
+   ```bash
+   # On remote server
+   pulseaudio --kill
+   pulseaudio --start --exit-idle-time=-1
+
+   # Disconnect and reconnect SSH
+   exit
+   ssh ubuntu-rdp
+   ```
+
+## Important Notes
+
+- **Firewall**: Ports 14713 and 4713 are only accessed via localhost/SSH tunnel, no external access needed
+- **Security**: All audio data travels through encrypted SSH tunnel
+- **Persistence**: All configuration is saved and will persist across reboots
+- **Kaspersky**: You can actually close the firewall exceptions for 14713 and 4713 since they're only localhost connections now
+
+## Quick Reference
+
+**Key Files Modified:**
+- `/home/fire/.ssh/config` (WSL)
+- `/mnt/c/Users/Paul/.ssh/config` (Windows)
+- `/home/fire/.config/pulse/client.conf`
+- `/home/fire/.bashrc`
+- `/home/fire/.zshrc`
+
+**Key Commands:**
+```bash
+# Check PulseAudio status
+pactl info
+
+# Check SSH tunnel
+ss -tlnp | grep :14713
+
+# Test audio
+speaker-test -t sine -f 1000 -l 1
+
+# Restart PulseAudio
+pulseaudio --kill && pulseaudio --start --exit-idle-time=-1
+
+# Restart socat (if needed)
+pkill socat
+socat TCP-LISTEN:14713,fork,reuseaddr UNIX-CONNECT:/mnt/wslg/PulseServer > /dev/null 2>&1 &
+```
+
+## Success Indicators
+
+You'll know it's working when:
+1. ✅ `pactl info` on remote shows `Server String: tcp:localhost:14713`
+2. ✅ `speaker-test` plays sound on your Windows speakers
+3. ✅ AgentVibes TTS plays through your Windows speakers
+4. ✅ No "Connection refused" or "Connection terminated" errors
+
+---
+
+*Generated by Claude Code on 2025-10-15*