agentvibes 4.4.1 → 4.5.0

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/reverb-level.txt

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

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

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

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

@@ -0,0 +1,112 @@
+#
+# 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
+
+# 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
+$VoiceMapFile = Join-Path $env:USERPROFILE ".agentvibes\bmad-voice-map.json"
+
+$AgentVoice = ""
+$AgentPersonality = ""
+
+if (Test-Path $VoiceMapFile) {
+    try {
+        $VoiceMap = Get-Content $VoiceMapFile -Raw | ConvertFrom-Json
+
+        # Resolve agent ID from display name or direct ID
+        $AgentId = $null
+
+        # Check direct match against manifest column 1
+        $ManifestRows = Import-Csv $ManifestFile
+        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 }
+        }
+    } 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
+}
+
+# ---------------------------------------------------------------------------
+# Apply per-agent personality override if set
+$OldPersonality = ""
+$PersonalityFile = Join-Path $ClaudeDir "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
+}
+
+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 original personality
+    if ($AgentPersonality -and $PersonalityFile) {
+        if ($OldPersonality) {
+            Set-Content $PersonalityFile $OldPersonality -NoNewline
+        } elseif (Test-Path $PersonalityFile) {
+            Remove-Item $PersonalityFile -Force -ErrorAction SilentlyContinue
+        }
+    }
+}

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
 

package/RELEASE_NOTES.md

@@ -1,5 +1,44 @@
 # AgentVibes Release Notes
 
+## 🌍 v4.5.0 — "Speak Every Language" Release
+
+**Release Date:** April 2026
+
+Full multilingual TUI support across all 9 languages, complete Windows security hardening, and zero failing tests.
+
+### 🌍 Multilingual TUI — 9 Languages
+
+Every screen, tab, button, and label in the `npx agentvibes` TUI is now fully translated:
+
+- **English, Spanish, French, German, Portuguese, Japanese, Korean, Chinese (Simplified), Italian**
+- Language selection on first launch (Screen 0 of the installer wizard)
+- Language sub-tab in Settings — switch language live without restarting
+- All tab bar labels, button text, footer hints, and status messages translated
+- BMAD tab and SSH Receiver tab fully localized
+- Per-language i18n files (`src/i18n/en.js`, `es.js`, `fr.js`, ...) with English fallback
+
+### 🪟 Windows Security & Bug Fixes
+
+- **Temp filenames** — All `Date.now()` temp filenames replaced with `randomUUID()` across JS and PowerShell (unpredictable, prevents temp file hijacking)
+- **Shell injection** — `execSync('which ...', { shell: true })` replaced with `spawnSync` (no shell expansion)
+- **Music player** — Hardcoded `ffplay` on Windows replaced with `detectMp3Player()` (respects user's installed player)
+- **Boolean coercion** — `isWindowsTerminal` now correctly returns `true/false` instead of leaking `WT_SESSION` UUID string
+- **Network mount detection** — `.match()` result properly coerced to boolean
+
+### 🎙️ 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.
+
+- `bin/bmad-speak.js` — cross-platform entry point for BMAD agent speech
+- `.claude/hooks-windows/bmad-speak.ps1` — native Windows BMAD speak with per-agent personality routing
+
+### 🧪 Test Suite
+
+- 600 tests, 0 failures
+- Full cross-platform coverage (Windows path separators, chmod skip, provider file restore)
+
+---
+
 ## 🎉 v4.4.0 — "Full Platform Parity" Release
 
 **Release Date:** March 2026

package/bin/agent-vibes

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes - Beautiful ElevenLabs TTS voice commands for Claude Code

package/bin/agentvibes-voice-browser.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes Voice Browser

package/bin/bmad-speak.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+/**
+ * AgentVibes - Cross-platform BMAD agent TTS entry point
+ *
+ * Delegates to the correct platform script:
+ *   Windows (non-WSL) → .claude/hooks-windows/bmad-speak.ps1
+ *   Linux/Mac/WSL     → .claude/hooks/bmad-speak.sh
+ *
+ * Usage: node bin/bmad-speak.js "Agent Name" "dialogue text"
+ */
+
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+
+const [, , agentName, dialogue] = process.argv;
+
+if (!agentName || !dialogue) {
+  process.stderr.write('Usage: bmad-speak.js "Agent Name" "dialogue text"\n');
+  process.exit(1);
+}
+
+const IS_WINDOWS = process.platform === 'win32' && !process.env.WSL_DISTRO_NAME;
+
+// Resolve script path — prefer project-local, fall back to global ~/.claude install
+function resolveScript(relPath) {
+  const cwdPath = path.join(process.cwd(), relPath);
+  const homePath = path.join(os.homedir(), relPath.replace(/^\.claude[\\/]/, '.claude/'));
+  if (fs.existsSync(cwdPath)) return cwdPath;
+  if (fs.existsSync(homePath)) return homePath;
+  return null;
+}
+
+let result;
+
+if (IS_WINDOWS) {
+  const script = resolveScript('.claude/hooks-windows/bmad-speak.ps1');
+  if (!script) process.exit(0);
+  result = spawnSync(
+    'powershell',
+    ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', script, agentName, dialogue],
+    { stdio: 'inherit' }
+  );
+} else {
+  const script = resolveScript('.claude/hooks/bmad-speak.sh');
+  if (!script) process.exit(0);
+  result = spawnSync('bash', [script, agentName, dialogue], { stdio: 'inherit' });
+}
+
+process.exit(result.status ?? 0);

package/bin/mcp-server.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes MCP Server Launcher (Cross-Platform)

package/bin/test-bmad-pr

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/usr/bin/env bash
 #
 # AgentVibes BMAD PR Testing Command
 # Quick command to test BMAD PRs with AgentVibes integration

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "4.4.1",
+  "version": "4.5.0",
   "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": [