agentvibes 4.4.1 → 4.5.7

package/.agentvibes/config.json

@@ -1,12 +1,12 @@
 {
   "backgroundMusic": {
     "track": "agent_vibes_cumbia_v1_loop.mp3",
-    "enabled": false,
-    "volume": 20
+    "enabled": true,
+    "volume": 10
   },
+  "voice": "en_US-libritts-high::Ella",
   "provider": "piper",
-  "voice": "en_US-libritts-high::Evan-8",
   "effects": {
-    "reverbPreset": "off"
+    "reverbPreset": "light"
   }
 }

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

@@ -1,3 +1,4 @@
+bmad-agent-tech-writer||agent_vibes_arabic_v2_loop.mp3|0.70
 # AgentVibes Audio Effects Configuration|||
 # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME
 #|||

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

@@ -0,0 +1 @@
+true

package/.claude/config/reverb-level.txt

@@ -1 +1 @@
-off
+light

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

@@ -1 +1 @@
-20260327
+20260329

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

@@ -343,7 +343,7 @@ main() {
             if [[ "$_prof_vol" =~ ^[0-9]+$ ]]; then
                 bg_volume=$(awk "BEGIN{printf \"%.2f\", ${_prof_vol}/100}")
             else
-                bg_volume="0.70"
+                bg_volume="0.20"
             fi
         fi
     fi

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

@@ -177,6 +177,20 @@ if [[ -n "$AGENT_ID" ]] && [[ -f "$VOICE_MAP_FILE" ]]; then
   IFS='|' read -r PROFILE_VOICE PROFILE_PRETEXT PROFILE_REVERB PROFILE_PERSONALITY PROFILE_MUSIC_TRACK PROFILE_MUSIC_VOLUME PROFILE_MUSIC_ENABLED <<< "$_ALL_FIELDS"
 fi
 
+# Read global background music volume as fallback (stored as 0.0-1.0, convert to 0-100 integer)
+_BG_VOL_FILE="${CLAUDE_PROJECT_DIR:-$PROJECT_ROOT}/.claude/config/background-music-volume.txt"
+if [[ ! -f "$_BG_VOL_FILE" ]]; then
+  _BG_VOL_FILE="$HOME/.claude/config/background-music-volume.txt"
+fi
+if [[ -f "$_BG_VOL_FILE" ]]; then
+  GLOBAL_BG_VOLUME=$(_BG_VOL_RAW=$(cat "$_BG_VOL_FILE") node -e "
+    const v = parseFloat(process.env._BG_VOL_RAW);
+    process.stdout.write(isNaN(v) ? '20' : String(Math.round(v * 100)));
+  " 2>/dev/null || echo "20")
+else
+  GLOBAL_BG_VOLUME=20
+fi
+
 # Fallback to bmad-voice-manager.sh if no profile voice found
 AGENT_VOICE="$PROFILE_VOICE"
 AGENT_INTRO="$PROFILE_PRETEXT"
@@ -203,7 +217,7 @@ if [[ -n "$PROFILE_REVERB" ]] || [[ -n "$PROFILE_PERSONALITY" ]] || [[ -n "$PROF
   # Write profile as JSON for reliable parsing downstream
   # SECURITY: Pass values via env vars to prevent shell injection
   _P_REVERB="$PROFILE_REVERB" _P_PERSONALITY="$PROFILE_PERSONALITY" \
-  _P_MUSIC_TRACK="$PROFILE_MUSIC_TRACK" _P_MUSIC_VOL="${PROFILE_MUSIC_VOLUME:-70}" \
+  _P_MUSIC_TRACK="$PROFILE_MUSIC_TRACK" _P_MUSIC_VOL="${PROFILE_MUSIC_VOLUME:-$GLOBAL_BG_VOLUME}" \
   _P_MUSIC_ENABLED="$PROFILE_MUSIC_ENABLED" \
   _P_OUTFILE="$TEMP_PROFILE" node -e "
     const p = {};
@@ -211,7 +225,7 @@ if [[ -n "$PROFILE_REVERB" ]] || [[ -n "$PROFILE_PERSONALITY" ]] || [[ -n "$PROF
     if (process.env._P_PERSONALITY) p.personality = process.env._P_PERSONALITY;
     if (process.env._P_MUSIC_TRACK) p.backgroundMusic = {
       track: process.env._P_MUSIC_TRACK,
-      volume: parseInt(process.env._P_MUSIC_VOL) || 70,
+      volume: parseInt(process.env._P_MUSIC_VOL) || 20,
       enabled: process.env._P_MUSIC_ENABLED === 'true'
     };
     require('fs').writeFileSync(process.env._P_OUTFILE, JSON.stringify(p), { mode: 0o600 });

package/.claude/hooks-windows/bmad-speak.ps1

@@ -0,0 +1,200 @@
+#
+# File: .claude/hooks-windows/bmad-speak.ps1
+#
+# AgentVibes BMAD Voice Integration - Windows
+# Maps BMAD agent display names or agent IDs to voices and triggers TTS.
+# Windows port of .claude/hooks/bmad-speak.sh
+#
+# Usage: bmad-speak.ps1 "Agent Name" "dialogue text"
+#        bmad-speak.ps1 "agent-id" "dialogue text"
+#
+
+param(
+    [Parameter(Mandatory = $true, Position = 0)]
+    [string]$AgentNameOrId,
+
+    [Parameter(Mandatory = $true, Position = 1)]
+    [string]$Dialogue
+)
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ClaudeDir = Split-Path -Parent $ScriptDir
+$ProjectRoot = Split-Path -Parent $ClaudeDir
+
+# When running as global script, prefer CLAUDE_PROJECT_DIR for project root
+if ($env:CLAUDE_PROJECT_DIR -and (Test-Path "$env:CLAUDE_PROJECT_DIR\_bmad")) {
+    $ProjectRoot = $env:CLAUDE_PROJECT_DIR
+}
+
+# Strip markdown formatting — prevent SAPI/Piper from speaking asterisks literally
+$Dialogue = $Dialogue -replace '\*\*', '' -replace '\*', '' -replace '`', ''
+$Dialogue = $Dialogue -replace '\\!', '!' -replace '\\\$', '$'
+
+# Check if party mode is disabled
+$PartyModeDisabledFlag = Join-Path $ProjectRoot ".agentvibes\bmad\bmad-party-mode-disabled.flag"
+if (Test-Path $PartyModeDisabledFlag) {
+    exit 0
+}
+
+# Check if BMAD is installed
+$ManifestFile = Join-Path $ProjectRoot "_bmad\_config\agent-manifest.csv"
+if (-not (Test-Path $ManifestFile)) {
+    exit 0
+}
+
+# ---------------------------------------------------------------------------
+# Read bmad-voice-map.json for per-agent profile
+# Prefer project-local voice map, fall back to global
+$VoiceMapLocal  = Join-Path $ProjectRoot ".agentvibes\bmad-voice-map.json"
+$VoiceMapGlobal = Join-Path $env:USERPROFILE ".agentvibes\bmad-voice-map.json"
+$VoiceMapFile   = if (Test-Path $VoiceMapLocal) { $VoiceMapLocal } else { $VoiceMapGlobal }
+
+$AgentVoice     = ""
+$AgentPersonality = ""
+$AgentBgEnabled = $false
+$AgentBgTrack   = ""
+$AgentId        = $null
+
+# Read global background music volume (stored as 0.0-1.0 float)
+$_BgVolFile = Join-Path $ProjectRoot ".claude\config\background-music-volume.txt"
+if (-not (Test-Path $_BgVolFile)) {
+    $_BgVolFile = Join-Path $env:USERPROFILE ".claude\config\background-music-volume.txt"
+}
+if (Test-Path $_BgVolFile) {
+    $_BgVolRaw = (Get-Content $_BgVolFile -Raw -ErrorAction SilentlyContinue).Trim()
+    $_BgVolParsed = 0.0
+    if ([double]::TryParse($_BgVolRaw, [System.Globalization.NumberStyles]::Float, [System.Globalization.CultureInfo]::InvariantCulture, [ref]$_BgVolParsed)) {
+        $AgentBgVolume = "{0:F2}" -f $_BgVolParsed
+    } else {
+        $AgentBgVolume = "0.20"
+    }
+} else {
+    $AgentBgVolume = "0.20"
+}
+
+if (Test-Path $VoiceMapFile) {
+    try {
+        $VoiceMap = Get-Content $VoiceMapFile -Raw | ConvertFrom-Json
+
+        # Resolve agent ID: match canonical ID or display name prefix
+        $ManifestRows = Import-Csv $ManifestFile -Encoding UTF8
+        foreach ($row in $ManifestRows) {
+            $id      = ($row.PSObject.Properties | Select-Object -First 1).Value -replace '^"|"$', ''
+            $display = ($row.PSObject.Properties | Select-Object -Skip 1 -First 1).Value -replace '^"|"$', ''
+            if ($id -ieq $AgentNameOrId -or $display -like "$AgentNameOrId*") {
+                $AgentId = $id
+                break
+            }
+        }
+
+        if ($AgentId -and $VoiceMap.agents.$AgentId) {
+            $Profile = $VoiceMap.agents.$AgentId
+            if ($Profile.voice)       { $AgentVoice       = $Profile.voice }
+            if ($Profile.personality) { $AgentPersonality = $Profile.personality }
+            if ($Profile.backgroundMusic) {
+                $AgentBgEnabled = [bool]$Profile.backgroundMusic.enabled
+                if ($Profile.backgroundMusic.track) { $AgentBgTrack = $Profile.backgroundMusic.track }
+                if ($null -ne $Profile.backgroundMusic.volume) {
+                    # Voice map stores 0-100; audio-effects.cfg uses 0.0-1.0
+                    $AgentBgVolume = "{0:F2}" -f ([double]$Profile.backgroundMusic.volume / 100.0)
+                }
+            }
+        }
+    } catch {
+        # Silently degrade — TTS will still play with global settings
+    }
+}
+
+# ---------------------------------------------------------------------------
+# Locate play-tts.ps1 — prefer project-local, fall back to global
+$PlayTtsLocal  = Join-Path $ProjectRoot ".claude\hooks-windows\play-tts.ps1"
+$PlayTtsGlobal = Join-Path $env:USERPROFILE ".claude\hooks-windows\play-tts.ps1"
+$PlayTtsScript = if (Test-Path $PlayTtsLocal) { $PlayTtsLocal } else { $PlayTtsGlobal }
+
+if (-not (Test-Path $PlayTtsScript)) {
+    exit 0
+}
+
+# ---------------------------------------------------------------------------
+# Determine which .claude config dir play-tts.ps1 will read.
+# play-tts.ps1 checks CLAUDE_PROJECT_DIR first — match that logic exactly.
+$TtsClaudeDir = if ($env:CLAUDE_PROJECT_DIR -and (Test-Path "$env:CLAUDE_PROJECT_DIR\.claude")) {
+    "$env:CLAUDE_PROJECT_DIR\.claude"
+} else {
+    $ClaudeDir  # ~/.claude (this script's own ClaudeDir)
+}
+$TtsConfigDir = Join-Path $TtsClaudeDir "config"
+
+# ---------------------------------------------------------------------------
+# Apply per-agent personality override if set
+$OldPersonality  = ""
+$PersonalityFile = Join-Path $TtsClaudeDir "config\personality.txt"
+if ($AgentPersonality -and (Test-Path (Split-Path $PersonalityFile -Parent))) {
+    if (Test-Path $PersonalityFile) {
+        $OldPersonality = (Get-Content $PersonalityFile -Raw).Trim()
+    }
+    Set-Content $PersonalityFile $AgentPersonality -NoNewline
+}
+
+# ---------------------------------------------------------------------------
+# Temporarily patch background music config for this agent.
+# The caller (bmad-party-speak.ps1) holds a named mutex so only one speak
+# call runs at a time — these file patches are safe from concurrent clobber.
+$BgEnabledFile   = Join-Path $TtsConfigDir "background-music-enabled.txt"
+$AudioEffectsCfg = Join-Path $TtsConfigDir "audio-effects.cfg"
+$OldBgEnabled    = $null
+$TempCfgLine     = ""
+
+if ($AgentBgEnabled -and $AgentBgTrack) {
+    # Save + enable background music
+    if (Test-Path $BgEnabledFile) {
+        $OldBgEnabled = (Get-Content $BgEnabledFile -Raw -ErrorAction SilentlyContinue).Trim()
+    }
+    Set-Content $BgEnabledFile "true" -NoNewline
+
+    # Prepend agent line to audio-effects.cfg so play-tts.ps1 finds it first
+    # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME
+    $TempCfgLine = "${AgentId}||${AgentBgTrack}|${AgentBgVolume}"
+    $env:AGENTVIBES_AGENT_NAME = $AgentId
+    $existingCfg = if (Test-Path $AudioEffectsCfg) {
+        Get-Content $AudioEffectsCfg -Raw -ErrorAction SilentlyContinue
+    } else { "" }
+    Set-Content $AudioEffectsCfg "${TempCfgLine}`n${existingCfg}" -NoNewline
+}
+
+try {
+    # Speak with agent's voice (or global voice if none configured)
+    if ($AgentVoice) {
+        & powershell -NoProfile -ExecutionPolicy Bypass -File $PlayTtsScript $Dialogue $AgentVoice
+    } else {
+        & powershell -NoProfile -ExecutionPolicy Bypass -File $PlayTtsScript $Dialogue
+    }
+} finally {
+    # Restore personality
+    if ($AgentPersonality -and $PersonalityFile) {
+        if ($OldPersonality) {
+            Set-Content $PersonalityFile $OldPersonality -NoNewline
+        } elseif (Test-Path $PersonalityFile) {
+            Remove-Item $PersonalityFile -Force -ErrorAction SilentlyContinue
+        }
+    }
+
+    # Restore background music config
+    if ($AgentBgEnabled -and $AgentBgTrack) {
+        if ($null -ne $OldBgEnabled) {
+            Set-Content $BgEnabledFile $OldBgEnabled -NoNewline
+        } elseif (Test-Path $BgEnabledFile) {
+            Remove-Item $BgEnabledFile -Force -ErrorAction SilentlyContinue
+        }
+
+        # Remove the prepended agent line from audio-effects.cfg
+        if (Test-Path $AudioEffectsCfg) {
+            $cfgRaw = Get-Content $AudioEffectsCfg -Raw -ErrorAction SilentlyContinue
+            $escaped = [regex]::Escape($TempCfgLine)
+            $cfgRaw  = $cfgRaw -replace "^${escaped}\r?\n?", ""
+            Set-Content $AudioEffectsCfg $cfgRaw -NoNewline
+        }
+
+        $env:AGENTVIBES_AGENT_NAME = ""
+    }
+}

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

@@ -1,5 +1,5 @@
 #
-# File: .claude/hooks-windows/play-tts-windows-piper.ps1
+# File: .claude/hooks-windows/play-tts-piper.ps1
 #
 # AgentVibes - Windows Piper TTS Provider
 # High-quality neural TTS using Piper.exe
@@ -162,9 +162,8 @@ $Text = $Text -replace '[{}<>|`~^;]', ''
 $Text = $Text -replace '\s+', ' '
 $Text = $Text.Trim()
 
-# Create audio file path
-$Timestamp = Get-Date -Format 'yyyyMMdd-HHmmss-ffff'
-$AudioFile = "$AudioDir\tts-$Timestamp.wav"
+# Create audio file path — SECURITY: use random name instead of predictable timestamp (#130)
+$AudioFile = "$AudioDir\tts-$([System.IO.Path]::GetRandomFileName() -replace '\..*').wav"
 
 # Synthesize with Piper
 try {

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

@@ -1,5 +1,5 @@
 #
-# File: .claude/hooks-windows/play-tts-windows-sapi.ps1
+# File: .claude/hooks-windows/play-tts-sapi.ps1
 #
 # AgentVibes - Windows SAPI TTS Provider (Zero Dependencies)
 # Uses built-in Windows System.Speech API
@@ -73,9 +73,8 @@ $Text = $Text.Trim()
 # Get actual voice name (after selection or default)
 $ActualVoice = $synth.Voice.Name
 
-# Create audio file path
-$Timestamp = Get-Date -Format 'yyyyMMdd-HHmmss-ffff'
-$AudioFile = "$AudioDir\tts-$Timestamp.wav"
+# Create audio file path — SECURITY: use random name instead of predictable timestamp (#130)
+$AudioFile = "$AudioDir\tts-$([System.IO.Path]::GetRandomFileName() -replace '\..*').wav"
 
 # Save to WAV file with proper resource cleanup
 $player = $null

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

@@ -53,9 +53,8 @@ if (-not (Test-Path $AudioDir)) {
     New-Item -ItemType Directory -Path $AudioDir -Force | Out-Null
 }
 
-$timestamp = Get-Date -Format "yyyyMMdd-HHmmss"
-$random = Get-Random -Maximum 9999
-$TempFile = Join-Path $AudioDir "tts-$timestamp-$random.wav"
+# SECURITY: use random name instead of predictable timestamp (#130)
+$TempFile = Join-Path $AudioDir "tts-$([System.IO.Path]::GetRandomFileName() -replace '\..*').wav"
 
 # Check WebUI server
 function Test-WebUI {

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

@@ -0,0 +1,138 @@
+#
+# File: .claude/hooks-windows/play-tts-termux-ssh.ps1
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# ---
+#
+# @fileoverview Termux SSH TTS Provider (Windows) - Android TTS via SSH tunnel
+# @context Enables TTS output on Android devices when connected via SSH from Windows
+# @architecture SSH-based remote TTS invocation using termux-tts-speak on Android
+# @dependencies ssh.exe (OpenSSH for Windows), termux-tts-speak (on Android), termux-api (on Android)
+# @entrypoints Called by play-tts.ps1 router when provider=termux-ssh
+# @patterns Remote TTS invocation, SSH host alias configuration, graceful fallback
+# @related play-tts.ps1, provider-manager.ps1
+#
+# SETUP INSTRUCTIONS:
+# ===================
+# 1. On Android device (Termux):
+#    - Install: pkg install termux-api openssh
+#    - Install Termux:API app from F-Droid or Google Play
+#    - Start SSH server: sshd
+#
+# 2. On Windows:
+#    - Add to %USERPROFILE%\.ssh\config:
+#      Host android
+#          HostName <your-android-ip>
+#          User <your-termux-username>
+#          Port 8022
+#          IdentityFile ~/.ssh/id_rsa
+#
+# 3. Configure AgentVibes:
+#    - echo android > %USERPROFILE%\.claude\termux-ssh-host.txt
+#    OR
+#    - echo android > .claude\termux-ssh-host.txt  (project-local)
+#
+# 4. Set provider:
+#    - echo termux-ssh > %USERPROFILE%\.claude\tts-provider.txt
+#
+
+param(
+    [Parameter(Mandatory = $true, Position = 0)]
+    [string]$Text,
+
+    [Parameter(Mandatory = $false, Position = 1)]
+    [string]$VoiceOverride  # Not used for termux-ssh, kept for interface compatibility
+)
+
+# Resolve ClaudeDir (project-local preferred, fallback to global)
+$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectClaudeDir = Split-Path -Parent $ScriptPath
+if (Test-Path (Join-Path $ProjectClaudeDir "config")) {
+    $ClaudeDir = $ProjectClaudeDir
+} else {
+    $ClaudeDir = "$env:USERPROFILE\.claude"
+}
+
+# @function Get-SshHost
+# @intent Determine SSH host alias for Android device
+# @why Allows users to configure their own SSH connection without hardcoded values
+# Priority: env var > project config > script-dir config > global config
+function Get-SshHost {
+    if ($env:TERMUX_SSH_HOST) { return $env:TERMUX_SSH_HOST }
+
+    $projectFile = Join-Path $ClaudeDir "termux-ssh-host.txt"
+    if (Test-Path $projectFile) {
+        $val = (Get-Content $projectFile -Raw).Trim()
+        if ($val) { return $val }
+    }
+
+    $globalFile = "$env:USERPROFILE\.claude\termux-ssh-host.txt"
+    if (Test-Path $globalFile) {
+        $val = (Get-Content $globalFile -Raw).Trim()
+        if ($val) { return $val }
+    }
+
+    return ""
+}
+
+# @function Test-SshConnection
+# @intent Quick reachability check before sending TTS
+# @why Prevents long hangs if Android is offline
+function Test-SshConnection {
+    param([string]$SshTarget)
+    try {
+        $null = ssh -o ConnectTimeout=2 -o BatchMode=yes $SshTarget "echo ok" 2>&1
+        return $LASTEXITCODE -eq 0
+    } catch {
+        return $false
+    }
+}
+
+# --- Main ---
+
+if (-not $Text) {
+    Write-Host "[ERROR] No text provided for TTS" -ForegroundColor Red
+    exit 1
+}
+
+$SshAlias = Get-SshHost
+
+if (-not $SshAlias) {
+    Write-Host "[ERROR] Termux SSH provider not configured" -ForegroundColor Red
+    Write-Host "  Set SSH host alias in one of:" -ForegroundColor Yellow
+    Write-Host "    Environment:  `$env:TERMUX_SSH_HOST = 'android'" -ForegroundColor Yellow
+    Write-Host "    Global:       echo android > `"$env:USERPROFILE\.claude\termux-ssh-host.txt`"" -ForegroundColor Yellow
+    Write-Host "    Project:      echo android > .claude\termux-ssh-host.txt" -ForegroundColor Yellow
+    exit 1
+}
+
+if (-not (Test-SshConnection -SshTarget $SshAlias)) {
+    Write-Host "[WARNING] Cannot connect to SSH host '$SshAlias' - Android offline?" -ForegroundColor Yellow
+    exit 1
+}
+
+# Escape single quotes for safe shell transmission
+$SafeText = $Text -replace "'", "'\'''"
+
+# Send TTS to Android asynchronously (audio plays on device)
+$job = Start-Job -ScriptBlock {
+    param($alias, $text)
+    ssh -o ConnectTimeout=5 $alias "termux-tts-speak '$text'" 2>&1
+} -ArgumentList $SshAlias, $SafeText
+
+Write-Host "[OK] TTS sent to Android ($SshAlias) via SSH" -ForegroundColor Green
+
+# Output empty string — audio plays on Android, not locally
+Write-Output ""

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

@@ -14,15 +14,20 @@ param(
 )
 
 # Configuration paths
-# First check if we're running from a project directory with .claude
+# Priority: CLAUDE_PROJECT_DIR env var → script's parent project → user profile
 $ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
 
-# Use project .claude if running from there, otherwise use user profile
-if (Test-Path $ProjectClaudeDir) {
-    $ClaudeDir = $ProjectClaudeDir
+if ($env:CLAUDE_PROJECT_DIR -and (Test-Path "$env:CLAUDE_PROJECT_DIR\.claude")) {
+    $ClaudeDir = "$env:CLAUDE_PROJECT_DIR\.claude"
 } else {
-    $ClaudeDir = "$env:USERPROFILE\.claude"
+    $PackageClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
+    if (Test-Path "$env:USERPROFILE\.claude\tts-provider.txt") {
+        $ClaudeDir = "$env:USERPROFILE\.claude"
+    } elseif (Test-Path $PackageClaudeDir) {
+        $ClaudeDir = $PackageClaudeDir
+    } else {
+        $ClaudeDir = "$env:USERPROFILE\.claude"
+    }
 }
 
 $HooksDir = "$ClaudeDir\hooks-windows"
@@ -56,6 +61,9 @@ switch ($ActiveProvider) {
     "soprano" {
         $ProviderScript = "$HooksDir\play-tts-soprano.ps1"
     }
+    "termux-ssh" {
+        $ProviderScript = "$HooksDir\play-tts-termux-ssh.ps1"
+    }
     default {
         Write-Host "[ERROR] Unknown provider: $ActiveProvider" -ForegroundColor Red
         Write-Host "Use: .\provider-manager.ps1 list" -ForegroundColor Yellow

package/.claude/hooks-windows/provider-manager.ps1

@@ -22,7 +22,7 @@ if (Test-Path (Join-Path $ProjectClaudeDir "config")) {
     $ClaudeDir = "$env:USERPROFILE\.claude"
 }
 $ProviderFile = "$ClaudeDir\tts-provider.txt"
-$ValidProviders = @('piper', 'sapi', 'soprano')
+$ValidProviders = @('piper', 'sapi', 'soprano', 'termux-ssh')
 # Backwards compat: normalize old names
 if ($Provider -eq 'windows-piper') { $Provider = 'piper' }
 if ($Provider -eq 'windows-sapi') { $Provider = 'sapi' }
@@ -91,6 +91,21 @@ function Get-AvailableProviders {
         installed = $sopranoInstalled
     }
 
+    # Check if termux-ssh is configured (ssh.exe available + host configured)
+    $termuxSshConfigured = $false
+    $sshExe = Get-Command ssh.exe -ErrorAction SilentlyContinue
+    if ($sshExe) {
+        $hostFile = "$ClaudeDir\termux-ssh-host.txt"
+        $globalHostFile = "$env:USERPROFILE\.claude\termux-ssh-host.txt"
+        $termuxSshConfigured = (Test-Path $hostFile) -or (Test-Path $globalHostFile) -or ($env:TERMUX_SSH_HOST -ne "")
+    }
+
+    $available += @{
+        name = "termux-ssh"
+        description = "Android Termux SSH TTS (plays on Android via termux-tts-speak)"
+        installed = $termuxSshConfigured
+    }
+
     return $available
 }
 

package/CLAUDE.md

@@ -8,6 +8,10 @@
 
 AgentVibes is a Text-to-Speech system for AI assistants with personality support.
 
+### Time Estimates
+
+Always estimate in **AI time** — Paul does not write code, that's Claude's job. "30 minutes" means 30 human minutes; the AI equivalent is seconds to a few minutes. When giving estimates, say things like "~10 minutes of AI work" or "quick — a few minutes tops."
+
 ### Project Uses BMAD Methodology
 
 This project follows **BMAD (BMM - Business Model Methodology)** for all story development:

package/README.md

@@ -4,14 +4,14 @@
 >
 > 🌐 **[agentvibes.org](https://agentvibes.org)**
 >
-> Professional text-to-speech for **Claude Code**, **Claude Desktop**, **Warp Terminal**, and **OpenClaw** - **Soprano** (Neural), **Piper TTS** (Free!), **macOS Say** (Built-in!), or **Windows SAPI** (Zero Setup!)
+> Professional text-to-speech for **Claude Code**, **Claude Desktop**, and **OpenClaw** - **Soprano** (Neural), **Piper TTS** (Free!), **macOS Say** (Built-in!), or **Windows SAPI** (Zero Setup!)
 
 [![npm version](https://img.shields.io/npm/v/agentvibes)](https://www.npmjs.com/package/agentvibes)
 [![Test Suite](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml)
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v4.4
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v4.5
 
 ---
 
@@ -36,11 +36,41 @@
 
 **AgentVibes adds lively voice narration to your Claude AI sessions!**
 
-Whether you're coding in Claude Code, chatting in Claude Desktop, using Warp Terminal, or running OpenClaw - AgentVibes brings AI to life with professional voices and personalities.
+Whether you're coding in Claude Code, chatting in Claude Desktop, or running OpenClaw — AgentVibes brings AI to life with professional voices and personalities.
 
 ---
 
-## 🌟 NEW IN v4.4 — Full Platform Parity Release
+## 🌟 NEW IN v4.5 — "Speak Every Language" Release
+
+### 🌍 Multilingual TUI — 9 Languages
+
+Every screen, button, and label in `npx agentvibes` is now fully translated:
+
+- **English, Spanish, French, German, Portuguese, Japanese, Korean, Chinese (Simplified), Italian**
+- Language selection on first launch — pick your language before anything else
+- Language sub-tab in Settings — switch live, no restart needed
+- All tab labels, buttons, footer hints, status messages, and BMAD/Receiver tabs translated
+- Per-language i18n files (`src/i18n/en.js`, `es.js`, `fr.js`, ...) with English fallback
+
+### 🪟 Windows Security Hardening
+
+- **Unpredictable temp files** — `randomUUID()` replaces `Date.now()` in all temp filenames (JS + PowerShell)
+- **No shell injection** — `spawnSync` replaces `execSync(..., { shell: true })` for `which` lookups
+- **Smart music player detection** — `detectMp3Player()` replaces hardcoded `ffplay` on Windows
+- **Boolean fix** — `isWindowsTerminal` now returns `true/false`, not the `WT_SESSION` UUID string
+
+### 🎙️ Cross-Platform BMAD Speak
+
+BMAD (Build More Architect Dreams) is an AI multi-agent framework where specialized agents — Architect, PM, Developer, QA, and Analyst — collaborate to build software. With this release, every agent in a BMAD party mode session now speaks aloud with their own unique voice, personality, and music on Windows — making each role instantly recognizable.
+
+- `bmad-speak.js` — cross-platform entry point; auto-routes to PowerShell on Windows or bash on Mac/Linux
+- `bmad-speak.ps1` — native Windows BMAD speak with per-agent personality routing
+
+### 🧪 600 Tests, Zero Failures
+
+---
+
+## 🌟 v4.4 — Full Platform Parity Release
 
 ### 🪟 Windows MCP Parity — 27/27 Tools Working
 
@@ -294,7 +324,7 @@ Configure via: `npx agentvibes` → Music tab
 - 🎭 **Multi-Provider Support** - Soprano (neural), Piper TTS (50+ free voices), macOS Say (100+ built-in), or Windows SAPI
 - 🎙️ **27+ Professional AI Voices** - Character voices, accents, and unique personalities
 - 🎙️ **Verbosity Control** - Choose how much Claude speaks (LOW, MEDIUM, HIGH)
-- 🎙️ **AgentVibes MCP** - Natural language control ("Switch to Aria voice") for Claude Code, Desktop & Warp
+- 🎙️ **AgentVibes MCP** - Natural language control ("Switch to Aria voice") for Claude Code & Desktop
 - 🔊 **SSH Audio Optimization** - Auto-detects remote sessions and eliminates static (VS Code Remote SSH, cloud dev)
 
 **🎭 Personalization:**
@@ -345,7 +375,7 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 ### AgentVibes MCP (Natural Language Control)
 - [🎙️ AgentVibes MCP Overview](#%EF%B8%8F-agentvibes-mcp) - **Easiest way** - Natural language commands
   - [For Claude Desktop](docs/mcp-setup.md#for-claude-desktop) - Windows/WSL setup, Python requirements
-  - [For Warp Terminal](docs/mcp-setup.md#for-warp-terminal) - Warp configuration
+
   - [For Claude Code](docs/mcp-setup.md#for-claude-code) - Project-specific setup
 
 ### Core Features
@@ -473,9 +503,9 @@ We've now enhanced this capability by adding an MCP (Model Context Protocol) ser
 
 Setting it up is straightforward: just add the MCP server to your Claude Code configuration files.
 
-But the convenience doesn't stop there. With the MCP server in place, Claude Desktop can now use Agent Vibes too! We've even tested it successfully with Warp, an AI assistant that helps you navigate Windows and other operating systems.
+But the convenience doesn't stop there. With the MCP server in place, Claude Desktop can now use Agent Vibes too!
 
-We're thrilled about this expansion because it means Claude Desktop and Warp can finally talk back as well!
+We're thrilled about this expansion because it means Claude Desktop can finally talk back as well!
 
 If you decide to use the MCP server on Claude Desktop, after configuration, give Claude Desktop this command: "every time i give you a command, speak the acknowledgement using agentvibes and the confirmation about what you completed, when done"—and watch the magic happen!
 
@@ -483,7 +513,7 @@ If you decide to use the MCP server on Claude Desktop, after configuration, give
 
 Just say "Switch to Aria voice" or "Speak in Spanish" instead of typing commands.
 
-**Works in:** Claude Desktop, Claude Code, Warp Terminal
+**Works in:** Claude Desktop, Claude Code
 
 **[→ View Complete MCP Setup Guide](docs/mcp-setup.md)** - Full setup for all platforms, configuration examples, available tools, and MCP vs slash commands comparison