agentvibes 5.6.8 → 5.6.9

package/.claude/hooks-windows/audio-cache-utils.ps1

@@ -1,119 +1,119 @@
-#
-# File: .claude/hooks-windows/audio-cache-utils.ps1
-#
-# AgentVibes Audio Cache Utilities for Windows
-#
-
-param(
-    [Parameter(Position = 0)]
-    [ValidateSet('cleanup', 'stats', 'clear')]
-    [string]$Command
-)
-
-# Detect project-local audio dir (same logic as TTS scripts)
-$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
-$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
-if (Test-Path $ProjectClaudeDir) {
-    $AudioDir = "$ProjectClaudeDir\audio"
-} else {
-    $AudioDir = "$env:USERPROFILE\.claude\audio"
-}
-
-function Ensure-AudioDir {
-    if (-not (Test-Path $AudioDir)) {
-        New-Item -ItemType Directory -Path $AudioDir -Force | Out-Null
-    }
-}
-
-function Get-AudioCacheSize {
-    Ensure-AudioDir
-
-    if (-not (Test-Path $AudioDir)) {
-        return 0
-    }
-
-    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue
-    $totalSize = 0
-
-    foreach ($file in $files) {
-        $totalSize += $file.Length
-    }
-
-    return $totalSize
-}
-
-function Format-FileSize {
-    param([long]$Size)
-
-    if ($Size -lt 1KB) { return "$Size B" }
-    if ($Size -lt 1MB) { return "{0:N2} KB" -f ($Size / 1KB) }
-    if ($Size -lt 1GB) { return "{0:N2} MB" -f ($Size / 1MB) }
-    return "{0:N2} GB" -f ($Size / 1GB)
-}
-
-function Get-CacheStats {
-    Ensure-AudioDir
-
-    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum
-
-    $count = if ($files.Count -eq $null) { 0 } else { $files.Count }
-    $totalSize = if ($files.Sum -eq $null) { 0 } else { $files.Sum }
-
-    return @{
-        FileCount = $count
-        TotalSize = $totalSize
-        FormattedSize = Format-FileSize $totalSize
-    }
-}
-
-function Clear-Cache {
-    Ensure-AudioDir
-
-    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue
-
-    if ($files.Count -eq 0) {
-        Write-Host "[OK] Cache already empty" -ForegroundColor Green
-        return
-    }
-
-    $stats = Get-CacheStats
-    Write-Host "[CLEANUP] Clearing $($stats.FileCount) audio files ($($stats.FormattedSize))" -ForegroundColor Yellow
-
-    foreach ($file in $files) {
-        Remove-Item $file.FullName -Force -ErrorAction SilentlyContinue
-    }
-
-    Write-Host "[OK] Cache cleared" -ForegroundColor Green
-}
-
-function Show-CacheStats {
-    Ensure-AudioDir
-
-    $stats = Get-CacheStats
-
-    Write-Host ""
-    Write-Host "[STATS] Audio Cache Statistics" -ForegroundColor Cyan
-    Write-Host "   Location: $AudioDir"
-    Write-Host "   Files: $($stats.FileCount)"
-    Write-Host "   Total Size: $($stats.FormattedSize)"
-    Write-Host ""
-}
-
-# Main command routing
-switch ($Command) {
-    'stats' {
-        Show-CacheStats
-    }
-
-    'cleanup' {
-        Clear-Cache
-    }
-
-    'clear' {
-        Clear-Cache
-    }
-
-    default {
-        Show-CacheStats
-    }
-}
+#
+# File: .claude/hooks-windows/audio-cache-utils.ps1
+#
+# AgentVibes Audio Cache Utilities for Windows
+#
+
+param(
+    [Parameter(Position = 0)]
+    [ValidateSet('cleanup', 'stats', 'clear')]
+    [string]$Command
+)
+
+# Detect project-local audio dir (same logic as TTS scripts)
+$ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
+$ProjectClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
+if (Test-Path $ProjectClaudeDir) {
+    $AudioDir = "$ProjectClaudeDir\audio"
+} else {
+    $AudioDir = "$env:USERPROFILE\.claude\audio"
+}
+
+function Ensure-AudioDir {
+    if (-not (Test-Path $AudioDir)) {
+        New-Item -ItemType Directory -Path $AudioDir -Force | Out-Null
+    }
+}
+
+function Get-AudioCacheSize {
+    Ensure-AudioDir
+
+    if (-not (Test-Path $AudioDir)) {
+        return 0
+    }
+
+    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue
+    $totalSize = 0
+
+    foreach ($file in $files) {
+        $totalSize += $file.Length
+    }
+
+    return $totalSize
+}
+
+function Format-FileSize {
+    param([long]$Size)
+
+    if ($Size -lt 1KB) { return "$Size B" }
+    if ($Size -lt 1MB) { return "{0:N2} KB" -f ($Size / 1KB) }
+    if ($Size -lt 1GB) { return "{0:N2} MB" -f ($Size / 1MB) }
+    return "{0:N2} GB" -f ($Size / 1GB)
+}
+
+function Get-CacheStats {
+    Ensure-AudioDir
+
+    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum
+
+    $count = if ($files.Count -eq $null) { 0 } else { $files.Count }
+    $totalSize = if ($files.Sum -eq $null) { 0 } else { $files.Sum }
+
+    return @{
+        FileCount = $count
+        TotalSize = $totalSize
+        FormattedSize = Format-FileSize $totalSize
+    }
+}
+
+function Clear-Cache {
+    Ensure-AudioDir
+
+    $files = Get-ChildItem -Path $AudioDir -Filter "*.wav" -ErrorAction SilentlyContinue
+
+    if ($files.Count -eq 0) {
+        Write-Host "[OK] Cache already empty" -ForegroundColor Green
+        return
+    }
+
+    $stats = Get-CacheStats
+    Write-Host "[CLEANUP] Clearing $($stats.FileCount) audio files ($($stats.FormattedSize))" -ForegroundColor Yellow
+
+    foreach ($file in $files) {
+        Remove-Item $file.FullName -Force -ErrorAction SilentlyContinue
+    }
+
+    Write-Host "[OK] Cache cleared" -ForegroundColor Green
+}
+
+function Show-CacheStats {
+    Ensure-AudioDir
+
+    $stats = Get-CacheStats
+
+    Write-Host ""
+    Write-Host "[STATS] Audio Cache Statistics" -ForegroundColor Cyan
+    Write-Host "   Location: $AudioDir"
+    Write-Host "   Files: $($stats.FileCount)"
+    Write-Host "   Total Size: $($stats.FormattedSize)"
+    Write-Host ""
+}
+
+# Main command routing
+switch ($Command) {
+    'stats' {
+        Show-CacheStats
+    }
+
+    'cleanup' {
+        Clear-Cache
+    }
+
+    'clear' {
+        Clear-Cache
+    }
+
+    default {
+        Show-CacheStats
+    }
+}

package/.claude/piper-voices-dir.txt

@@ -0,0 +1 @@
+/home/fire/.claude/piper-voices

package/.clawdbot/README.md

@@ -1,105 +1,105 @@
-# Clawdbot Integration
-
-AgentVibes TTS integration for Clawdbot - the AI assistant framework.
-
-## What is Clawdbot?
-
-Clawdbot is a powerful AI assistant framework that connects Claude AI to messaging platforms (WhatsApp, Telegram, Discord, etc.) and provides extensible skills.
-
-**Website**: https://clawd.bot
-**GitHub**: https://github.com/clawdbot/clawdbot
-
-## AgentVibes + Clawdbot
-
-This integration provides Clawdbot with professional TTS capabilities using AgentVibes:
-
-- **Free & Offline**: No API costs, works without internet
-- **50+ Voices**: Professional AI voices in 30+ languages
-- **Remote SSH Support**: Audio tunnels from server to local machine
-- **Zero Setup**: Automatic when AgentVibes is installed
-
-## Installation
-
-```bash
-npx agentvibes install
-```
-
-That's it! AgentVibes is ready to use.
-
-## Usage from Clawdbot
-
-Once installed, use AgentVibes for TTS:
-
-```bash
-npx agentvibes speak "Hello from Clawdbot"
-```
-
-## Features
-
-- **Automatic Detection**: Clawdbot automatically uses AgentVibes when available
-- **Voice Selection**: 50+ voices across 30+ languages
-- **SSH Tunneling**: Audio plays on local machine from remote servers
-- **Zero Config**: Works out of the box once AgentVibes is installed
-
-## Remote SSH Audio
-
-When running Clawdbot on a remote server, set up PulseAudio tunneling so audio plays on your local machine:
-
-**Quick Setup:**
-
-1. **Remote server** (`~/.bashrc`):
-```bash
-export PULSE_SERVER=tcp:localhost:14713
-```
-
-2. **Local machine** (`~/.ssh/config`):
-```
-Host your-server
-    RemoteForward 14713 localhost:14713
-```
-
-3. **Connect and test**:
-```bash
-ssh your-server
-agentvibes speak "Testing remote audio"
-```
-
-**Full guide**: https://github.com/paulpreibisch/AgentVibes/blob/master/docs/remote-audio-setup.md
-
-## Documentation
-
-- **Skill Documentation**: [skill/SKILL.md](skill/SKILL.md)
-- **AgentVibes Docs**: https://agentvibes.org
-- **Clawdbot Docs**: https://docs.clawd.bot
-
-## Architecture
-
-```
-Clawdbot Request
-    ↓
-AgentVibes Skill (this)
-    ↓
-AgentVibes CLI (agentvibes speak)
-    ↓
-Piper TTS Engine
-    ↓
-PulseAudio → SSH Tunnel → Local Speakers
-```
-
-## Development
-
-The skill is automatically packaged with AgentVibes npm releases. To update:
-
-1. Edit `skill/SKILL.md`
-2. Test with Clawdbot
-3. Commit to AgentVibes repo
-4. Publish new AgentVibes version
-
-## Support
-
-- **AgentVibes Issues**: https://github.com/paulpreibisch/AgentVibes/issues
-- **Clawdbot Issues**: https://github.com/clawdbot/clawdbot/issues
-
-## License
-
-Apache 2.0 - Same as AgentVibes
+# Clawdbot Integration
+
+AgentVibes TTS integration for Clawdbot - the AI assistant framework.
+
+## What is Clawdbot?
+
+Clawdbot is a powerful AI assistant framework that connects Claude AI to messaging platforms (WhatsApp, Telegram, Discord, etc.) and provides extensible skills.
+
+**Website**: https://clawd.bot
+**GitHub**: https://github.com/clawdbot/clawdbot
+
+## AgentVibes + Clawdbot
+
+This integration provides Clawdbot with professional TTS capabilities using AgentVibes:
+
+- **Free & Offline**: No API costs, works without internet
+- **50+ Voices**: Professional AI voices in 30+ languages
+- **Remote SSH Support**: Audio tunnels from server to local machine
+- **Zero Setup**: Automatic when AgentVibes is installed
+
+## Installation
+
+```bash
+npx agentvibes install
+```
+
+That's it! AgentVibes is ready to use.
+
+## Usage from Clawdbot
+
+Once installed, use AgentVibes for TTS:
+
+```bash
+npx agentvibes speak "Hello from Clawdbot"
+```
+
+## Features
+
+- **Automatic Detection**: Clawdbot automatically uses AgentVibes when available
+- **Voice Selection**: 50+ voices across 30+ languages
+- **SSH Tunneling**: Audio plays on local machine from remote servers
+- **Zero Config**: Works out of the box once AgentVibes is installed
+
+## Remote SSH Audio
+
+When running Clawdbot on a remote server, set up PulseAudio tunneling so audio plays on your local machine:
+
+**Quick Setup:**
+
+1. **Remote server** (`~/.bashrc`):
+```bash
+export PULSE_SERVER=tcp:localhost:14713
+```
+
+2. **Local machine** (`~/.ssh/config`):
+```
+Host your-server
+    RemoteForward 14713 localhost:14713
+```
+
+3. **Connect and test**:
+```bash
+ssh your-server
+agentvibes speak "Testing remote audio"
+```
+
+**Full guide**: https://github.com/paulpreibisch/AgentVibes/blob/master/docs/remote-audio-setup.md
+
+## Documentation
+
+- **Skill Documentation**: [skill/SKILL.md](skill/SKILL.md)
+- **AgentVibes Docs**: https://agentvibes.org
+- **Clawdbot Docs**: https://docs.clawd.bot
+
+## Architecture
+
+```
+Clawdbot Request
+    ↓
+AgentVibes Skill (this)
+    ↓
+AgentVibes CLI (agentvibes speak)
+    ↓
+Piper TTS Engine
+    ↓
+PulseAudio → SSH Tunnel → Local Speakers
+```
+
+## Development
+
+The skill is automatically packaged with AgentVibes npm releases. To update:
+
+1. Edit `skill/SKILL.md`
+2. Test with Clawdbot
+3. Commit to AgentVibes repo
+4. Publish new AgentVibes version
+
+## Support
+
+- **AgentVibes Issues**: https://github.com/paulpreibisch/AgentVibes/issues
+- **Clawdbot Issues**: https://github.com/clawdbot/clawdbot/issues
+
+## License
+
+Apache 2.0 - Same as AgentVibes

package/.mcp.json

@@ -1,12 +1,41 @@
 {
   "mcpServers": {
-    "firecrawl-mcp": {
+    "context7": {
       "command": "npx",
       "args": [
-        "-y",
-        "firecrawl-mcp"
+        "@upstash/context7-mcp"
       ]
     },
+    "sonarqube": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--name",
+        "sonarqube-mcp-server-agentvibes",
+        "--rm",
+        "--dns",
+        "8.8.8.8",
+        "--dns",
+        "8.8.4.4",
+        "-e",
+        "SONARQUBE_TOKEN",
+        "-e",
+        "SONARQUBE_ORG",
+        "-e",
+        "STORAGE_PATH",
+        "mcp/sonarqube"
+      ],
+      "env": {
+        "SONARQUBE_TOKEN": "${SONARQUBE_TOKEN}",
+        "SONARQUBE_ORG": "${SONARQUBE_ORG}",
+        "STORAGE_PATH": "${STORAGE_PATH}"
+      }
+    },
+    "vercel": {
+      "type": "sse",
+      "url": "https://mcp.vercel.com"
+    },
     "agentvibes": {
       "command": "npx",
       "args": [

package/README.md

@@ -11,7 +11,7 @@
 [![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**: v5.6.8
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.6.9
 
 ---
 
@@ -40,7 +40,17 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, using Warp Ter
 
 ---
 
-## 🌟 NEW IN v5.6.8 — WSL Voice Routing Fixed + Session Lifecycle Reliability
+## 🌟 NEW IN v5.6.9 — Reverb & Background Music Silent in NPX Installs
+
+**NPX users:** Reverb and background music were silently broken for all `npx`-installed users. Hook files extracted from the npm tarball lacked execute bits (644), causing `audio-processor.sh` to exit with code 126. Fixed via `bash` prefix in the caller and a postinstall `chmod 755` step.
+
+**Voice Browser:** The Preview button now applies your configured reverb and background music — it was playing raw audio with no effects.
+
+**MCP tool:** `text_to_speech` now returns the correct audio file path (no trailing emoji garbage) and includes the voice name in its response.
+
+**Background music toggle:** Enabling music in the TUI now actually enables it — the flag file read by bash hooks is now kept in sync.
+
+## v5.6.8 — WSL Voice Routing Fixed + Session Lifecycle Reliability
 
 **WSL users:** AgentVibes was playing `en_US-lessac-medium` regardless of your configured voice. Fixed — Piper is now found in non-interactive shells by explicitly prepending `~/.local/bin` to `PATH` before the binary check.
 

package/RELEASE_NOTES.md

@@ -1,5 +1,34 @@
 # AgentVibes Release Notes
 
+## 🔇 v5.6.9 — Reverb & Background Music Silent in NPX Installs
+
+**Released:** 2026-05-09
+
+### 🐛 Reverb and Background Music Silently Broken for All NPX Users
+
+When AgentVibes is installed via `npx`, hook files are extracted from the tarball with 644 permissions — no execute bit. `play-tts-piper.sh` called `audio-processor.sh` directly, which exits immediately with code 126 (Permission denied) on a non-executable file. Every `npx`-installed user was getting voice-only TTS — no reverb, no background music, silently.
+
+**Fix 1:** `play-tts-piper.sh` now calls `audio-processor.sh` via `bash "$SCRIPT_DIR/audio-processor.sh"`, bypassing the execute-bit check.
+**Fix 2:** `install-deps.js` (postinstall) now runs `ensureHookPermissions()` to `chmod 755` all `.sh` files after npm install.
+
+### 🐛 Voice Browser Preview Ignored Reverb and Background Music
+
+The **Preview** button in the Voice Browser played raw piper output with no reverb and no background music, bypassing `audio-processor.sh` entirely.
+
+**Fix:** Preview audio now routes through the same `audio-processor.sh` pipeline as real TTS.
+
+### 🐛 MCP `text_to_speech` Returned Garbled File Path and Missing Voice Info
+
+The tool extracted the audio file path incorrectly (trailing size/emoji characters included) and never reported the voice name in its response.
+
+**Fix:** ANSI codes are stripped before parsing, the `.wav` path is cleanly extracted, and the `🎤 Voice used:` line is included in the tool response.
+
+### 🐛 Background Music TUI Toggle Didn't Take Effect
+
+Enabling background music in the **Music** tab wrote to `config.json` but not to `background-music-enabled.txt` (read by bash hooks). Music stayed off after toggling. Saving a track also now implies enabling music.
+
+---
+
 ## 🐧 v5.6.8 — WSL Voice Routing Fixed + Session Lifecycle Reliability
 
 **Released:** 2026-05-09