agentvibes 4.5.0 → 4.5.7

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/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

@@ -21,6 +21,11 @@ $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 '\\\$', '$'
@@ -39,22 +44,42 @@ if (-not (Test-Path $ManifestFile)) {
 
 # ---------------------------------------------------------------------------
 # Read bmad-voice-map.json for per-agent profile
-$VoiceMapFile = Join-Path $env:USERPROFILE ".agentvibes\bmad-voice-map.json"
+# 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 = ""
+$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 from display name or direct ID
-        $AgentId = $null
-
-        # Check direct match against manifest column 1
-        $ManifestRows = Import-Csv $ManifestFile
+        # 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 '^"|"$', ''
+            $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
@@ -64,8 +89,16 @@ if (Test-Path $VoiceMapFile) {
 
         if ($AgentId -and $VoiceMap.agents.$AgentId) {
             $Profile = $VoiceMap.agents.$AgentId
-            if ($Profile.voice) { $AgentVoice = $Profile.voice }
+            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
@@ -74,7 +107,7 @@ if (Test-Path $VoiceMapFile) {
 
 # ---------------------------------------------------------------------------
 # Locate play-tts.ps1 — prefer project-local, fall back to global
-$PlayTtsLocal = Join-Path $ProjectRoot ".claude\hooks-windows\play-tts.ps1"
+$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 }
 
@@ -82,10 +115,20 @@ 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 $ClaudeDir "config\personality.txt"
+$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()
@@ -93,6 +136,32 @@ if ($AgentPersonality -and (Test-Path (Split-Path $PersonalityFile -Parent))) {
     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) {
@@ -101,7 +170,7 @@ try {
         & powershell -NoProfile -ExecutionPolicy Bypass -File $PlayTtsScript $Dialogue
     }
 } finally {
-    # Restore original personality
+    # Restore personality
     if ($AgentPersonality -and $PersonalityFile) {
         if ($OldPersonality) {
             Set-Content $PersonalityFile $OldPersonality -NoNewline
@@ -109,4 +178,23 @@ try {
             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/RELEASE_NOTES.md

@@ -1,5 +1,30 @@
 # AgentVibes Release Notes
 
+## 🐛 v4.5.7 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **Background music volume default** — All volume defaults lowered from 70% to 20% across the UI (settings tab, agents tab, music tab, track picker). New installs and newly configured agents will default to a much more reasonable background music level.
+- **bmad-speak volume inheritance** — `bmad-speak.sh` and `bmad-speak.ps1` now read the global `background-music-volume.txt` config file as the fallback volume instead of a hardcoded value. Per-agent background music volume now correctly inherits the global setting when no explicit per-agent override is saved.
+
+---
+
+## 🐛 v4.5.1 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fix
+
+- **Music tab preview** — Pressing Space on a track in the Music tab now plays correctly
+  when running `npx agentvibes` from a fresh directory. Previously, if `.claude/audio/tracks/`
+  didn't exist in the current working directory, the track list showed built-in tracks but
+  Space did nothing (the player was spawned against a non-existent path). Now falls back to
+  the package-bundled tracks directory automatically.
+
+---
+
 ## 🌍 v4.5.0 — "Speak Every Language" Release
 
 **Release Date:** April 2026
@@ -27,8 +52,22 @@ Every screen, tab, button, and label in the `npx agentvibes` TUI is now fully tr
 
 ### 🎙️ 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 (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.
+
+## 🐛 v4.5.1 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fix
+
+- **Music tab preview** — Pressing Space on a track in the Music tab now plays correctly
+  when running `npx agentvibes` from a fresh directory. Previously, if `.claude/audio/tracks/`
+  didn't exist in the current working directory, the track list showed built-in tracks but
+  Space did nothing (the player was spawned against a non-existent path). Now falls back to
+  the package-bundled tracks directory automatically.
+
+---
+
 - `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
 

package/package.json

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

package/src/console/app.js

@@ -825,7 +825,11 @@ export class AgentVibesConsole {
     });
 
     // Register global key bindings (S/V/M/A/R/H/I/T/Esc)
-    setupNavigation(this.screen, this.navigationService);
+    setupNavigation(this.screen, this.navigationService, () => {
+      const id = this.navigationService.getActiveTab();
+      const item = this._tabItems?.[id];
+      if (item) item.focus();
+    });
   }
 
   // ---------------------------------------------------------------------------

package/src/console/navigation.js

@@ -35,8 +35,9 @@ const KEY_TO_TAB = {
  *
  * @param {object} screen - Blessed screen instance (or stub in tests)
  * @param {import('../services/navigation-service.js').NavigationService} navigationService
+ * @param {function} [focusMainTabBar] - Optional callback to return focus to the tab bar
  */
-export function setupNavigation(screen, navigationService) {
+export function setupNavigation(screen, navigationService, focusMainTabBar) {
   // Tab switching shortcuts — one handler per key (both cases)
   for (const [key, tabId] of Object.entries(KEY_TO_TAB)) {
     screen.key([key], () => {
@@ -53,10 +54,12 @@ export function setupNavigation(screen, navigationService) {
     }
   });
 
-  // Escape — close modal (story 6.4 will expand modal handling)
+  // Escape — close modal if open, otherwise return focus to tab bar
   screen.key(['escape'], () => {
     if (navigationService.isModalOpen()) {
       navigationService.closeModal();
+    } else if (typeof focusMainTabBar === 'function') {
+      focusMainTabBar();
     }
   });
 }

package/src/console/tabs/agents-tab.js

@@ -319,7 +319,7 @@ ${_tl('bmadDesc')}
   }
 
   const resetBtn = _createBtn('[X] Reset', () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) {
       voiceStore.resetAgentProfile(agent.id);
       refreshDisplay();
@@ -374,7 +374,7 @@ ${_tl('bmadDesc')}
         ? formatTrackName(profile.backgroundMusic.track)
         : '(global)')).padEnd(COL_MUSIC).slice(0, COL_MUSIC);
       const vol = profile.backgroundMusic?.enabled
-        ? ` ${profile.backgroundMusic.volume ?? 70}%`.padEnd(COL_VOL)
+        ? ` ${profile.backgroundMusic.volume ?? 20}%`.padEnd(COL_VOL)
         : '  —  ';
       const pretext = ' ' + (profile.pretext || '(default)').slice(0, COL_PRETEXT - 1);
       return ` ${icon}${name}${voice}${gender}${provider}${reverb}${music}${vol}  ${pretext}`;
@@ -513,7 +513,7 @@ ${_tl('bmadDesc')}
       personality:     profile.personality   || globalCfg.personality || 'none',
       backgroundMusic: {
         track:   profile.backgroundMusic?.track   || globalCfg.backgroundMusic?.track || '',
-        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 70,
+        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 20,
         enabled: profile.backgroundMusic?.enabled ?? globalCfg.backgroundMusic?.enabled ?? false,
       },
     });
@@ -534,7 +534,7 @@ ${_tl('bmadDesc')}
       personality:     profile.personality   || globalCfg.personality || 'none',
       backgroundMusic: {
         track:   profile.backgroundMusic?.track   || globalCfg.backgroundMusic?.track || '',
-        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 70,
+        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 20,
         enabled: profile.backgroundMusic?.enabled ?? globalCfg.backgroundMusic?.enabled ?? false,
       },
     };
@@ -657,7 +657,7 @@ ${_tl('bmadDesc')}
       if (draft.reverbPreset !== (globalCfg.effects?.reverbPreset || 'light')) toSave.reverbPreset = draft.reverbPreset;
       if (draft.personality !== (globalCfg.personality || 'none')) toSave.personality = draft.personality;
       if (draft.backgroundMusic.track !== (globalCfg.backgroundMusic?.track || '') ||
-          draft.backgroundMusic.volume !== (globalCfg.backgroundMusic?.volume ?? 70) ||
+          draft.backgroundMusic.volume !== (globalCfg.backgroundMusic?.volume ?? 20) ||
           draft.backgroundMusic.enabled !== (globalCfg.backgroundMusic?.enabled ?? false)) {
         toSave.backgroundMusic = draft.backgroundMusic;
       }
@@ -1275,7 +1275,7 @@ ${_tl('bmadDesc')}
       const track = shuffled[i % shuffled.length];
       const existing = voiceStore.getAgentProfile(agent.id);
       voiceStore.setAgentProfile(agent.id, {
-        backgroundMusic: { track, volume: existing.backgroundMusic?.volume ?? 70, enabled: true },
+        backgroundMusic: { track, volume: existing.backgroundMusic?.volume ?? 20, enabled: true },
       });
     });
     return true;
@@ -1373,7 +1373,7 @@ ${_tl('bmadDesc')}
 
         case 'setMusic':
           _closeMenu(() => {
-            openTrackPicker(screen, '', 70, (track, volume) => {
+            openTrackPicker(screen, '', 20, (track, volume) => {
               _agents.forEach(agent => {
                 const p = voiceStore.getAgentProfile(agent.id);
                 voiceStore.setAgentProfile(agent.id, {
@@ -1389,7 +1389,7 @@ ${_tl('bmadDesc')}
 
         case 'setVolume':
           _closeMenu(() => {
-            const curVol = voiceStore.getAgentProfile(_agents[0]?.id)?.backgroundMusic?.volume ?? 70;
+            const curVol = voiceStore.getAgentProfile(_agents[0]?.id)?.backgroundMusic?.volume ?? 20;
             openVolumeInput(screen, curVol, (volume) => {
               _agents.forEach(agent => {
                 const p = voiceStore.getAgentProfile(agent.id);
@@ -1504,7 +1504,7 @@ ${_tl('bmadDesc')}
   // Key bindings
 
   agentList.key(['x', 'X'], () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) {
       voiceStore.resetAgentProfile(agent.id);
       refreshDisplay();
@@ -1513,12 +1513,12 @@ ${_tl('bmadDesc')}
 
 
   agentList.key(['enter'], () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) _openAgentDetailPanel(agent);
   });
 
   agentList.key(['space'], () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) _sampleAgent(agent);
   });
 

package/src/console/tabs/install-tab.js

@@ -443,9 +443,10 @@ export function createInstallTab(screen, services) {
 
     _renderScreen5();
 
-    // Show OK button now that install is done (success or error)
-    _s5OkBtn.show();
-    _s5OkBtn.focus();
+    // Show buttons now that install is done (success or error)
+    _s5QuitBtn.show();
+    _s5CustomizeBtn.show();
+    _s5QuitBtn.focus();
     screen.render();
 
     // Play TTS greeting on success
@@ -579,12 +580,25 @@ export function createInstallTab(screen, services) {
   // Screen 3: no Continue button — Enter/→ on the list confirms selection and advances
 
   // -------------------------------------------------------------------------
-  // Screen 5 button — OK (summary page only, config already saved on screen 4)
+  // Screen 5 buttons — Customize More (left) + Done - Quit (right, default focused)
+  // Layout: [  Customize More  ]   [  Done - Quit  ]
+  // Button width = label + 2 padding chars; gap between buttons = 3 chars
 
-  const _s5OkBtn = _createInstallBtn(_tl('okDoneBtn'), '#1565c0', () => {
+  const _s5CustomizeBtn = _createInstallBtn(_tl('doneCustomizeBtn'), '#1565c0', () => {
     _dismissCompletionModal();
   });
-  _s5OkBtn.bottom = 3; _s5OkBtn.left = 4;  // bottom-anchored: sits above hintLine (bottom:2)
+  _s5CustomizeBtn.bottom = 3; _s5CustomizeBtn.left = 4;
+
+  const _s5QuitBtn = _createInstallBtn(_tl('doneQuitBtn'), '#b71c1c', () => {
+    screen.destroy();
+    process.exit(0);
+  });
+  // left = start(4) + customizeLabel + 2 padding + 3 gap
+  _s5QuitBtn.bottom = 3; _s5QuitBtn.left = 4 + _tl('doneCustomizeBtn').length + 2 + 3;
+
+  // Arrow/Tab navigation between the two buttons
+  _s5CustomizeBtn.key(['tab', 'right'], () => { _s5QuitBtn.focus(); screen.render(); });
+  _s5QuitBtn.key(['tab', 'left', 'S-tab'], () => { _s5CustomizeBtn.focus(); screen.render(); });
 
   // -------------------------------------------------------------------------
   // Screen renderers
@@ -827,11 +841,13 @@ export function createInstallTab(screen, services) {
     // Screen 2 continue button: hidden on other screens; _renderScreen2 manages show/focus
     if (_screen !== 2) _s2ContinueBtn.hide();
 
-    // Screen 5 OK button: hidden during active install, shown by _runInstall() on completion
+    // Screen 5 buttons: hidden during active install, shown by _runInstall() on completion
     if (_screen === 5 && (_installComplete || _installError)) {
-      _s5OkBtn.show();
+      _s5QuitBtn.show();
+      _s5CustomizeBtn.show();
     } else {
-      _s5OkBtn.hide();
+      _s5QuitBtn.hide();
+      _s5CustomizeBtn.hide();
     }
 
     // Show Screen 4 action buttons only on screen 4
@@ -1047,7 +1063,7 @@ export function createInstallTab(screen, services) {
       } else if (_screen === 4) {
         _editBtn.focus();
       } else if (_screen === 5 && (_installComplete || _installError)) {
-        _s5OkBtn.focus();
+        _s5QuitBtn.focus();
       } else {
         box.focus();
       }

package/src/console/tabs/music-tab.js

@@ -12,10 +12,17 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
+import { fileURLToPath } from 'node:url';
 import { spawn } from 'node:child_process';
 import { buildAudioEnv, detectMp3Player } from '../audio-env.js';
 import { t } from '../../i18n/strings.js';
 
+// Package-relative tracks dir — used as fallback when cwd has no .claude/audio/tracks/
+const _PKG_TRACKS_DIR = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  '..', '..', '..', '.claude', 'audio', 'tracks'
+);
+
 const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
 
 let blessed;
@@ -157,7 +164,9 @@ function createTestStub() {
  * @returns {string}
  */
 function _getTracksDir() {
-  return path.join(process.cwd(), '.claude', 'audio', 'tracks');
+  const cwdTracks = path.join(process.cwd(), '.claude', 'audio', 'tracks');
+  // Fall back to package-bundled tracks if cwd doesn't have any
+  return fs.existsSync(cwdTracks) ? cwdTracks : _PKG_TRACKS_DIR;
 }
 
 /**
@@ -191,7 +200,7 @@ function _getMusic(configService) {
   return {
     enabled: music.enabled ?? false,
     track:   music.track ?? BUILT_IN_TRACK_CATALOG[0].id,
-    volume:  music.volume ?? 70,
+    volume:  music.volume ?? 20,
   };
 }
 

package/src/console/tabs/settings-tab.js

@@ -108,7 +108,7 @@ const FOOTER_TEXT =
 const EFFECTS_DEFAULTS = Object.freeze({ reverbPreset: 'light' });
 
 // Default background music config
-const MUSIC_DEFAULTS = Object.freeze({ enabled: false, track: 'agentvibes_soft_flamenco_loop.mp3', volume: 70 });
+const MUSIC_DEFAULTS = Object.freeze({ enabled: false, track: 'agentvibes_soft_flamenco_loop.mp3', volume: 20 });
 
 // Verbosity display labels
 const VERBOSITY_LABELS = Object.freeze({ high: 'High', medium: 'Medium', low: 'Low', minimal: 'Minimal', custom: 'Custom' });

package/src/console/widgets/track-picker.js

@@ -279,7 +279,7 @@ export function openTrackPicker(screen, currentTrack, currentVolume, onSelect, o
     _killPreview();
     if (list._label2) list._label2.destroy();
     destroyList(list, screen, null);
-    openVolumeInput(screen, currentVolume ?? 70, (volume) => {
+    openVolumeInput(screen, currentVolume ?? 20, (volume) => {
       onSelect(selected.file, volume);
     }, onClose);
   });

package/src/i18n/de.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Weiter →",
   acceptInstallBtn: "✓ Akzeptieren & Installieren",
   okDoneBtn: "✓  OK — Fertig",
+  doneCustomizeBtn: "✓  Fertig - Mehr anpassen",
+  doneQuitBtn: "✕  Fertig - Beenden",
   editInstallBtn: "Bearbeiten",
   musicDisabledMsg: "Musik deaktiviert. Jetzt aktivieren?",
   settingsFooter: "[↑↓] Gruppe  [←→] Geschwister/Sub-Tab  [Enter/Space] Aktivieren  [Tab] Tab Wechseln  [Q] Beenden",

package/src/i18n/en.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Continue →",
   acceptInstallBtn: "✓ Accept & Install",
   okDoneBtn: "✓  OK — Done",
+  doneCustomizeBtn: "✓  Done - Customize More",
+  doneQuitBtn: "✕  Done - Quit",
   editInstallBtn: "Edit",
   musicDisabledMsg: "Music is disabled. Enable it now?",
   settingsFooter: "[↑↓] Group  [←→] Sibling/Sub-tab  [Enter/Space] Activate  [Tab] Switch Tab  [Q] Quit",

package/src/i18n/es.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Continuar →",
   acceptInstallBtn: "✓ Aceptar e Instalar",
   okDoneBtn: "✓  OK — Listo",
+  doneCustomizeBtn: "✓  Listo - Personalizar más",
+  doneQuitBtn: "✕  Listo - Salir",
   editInstallBtn: "Editar",
   musicDisabledMsg: "Música desactivada. ¿Activar ahora?",
   settingsFooter: "[↑↓] Grupo  [←→] Hermano/Sub-tab  [Enter/Space] Activar  [Tab] Cambiar Tab  [Q] Salir",

package/src/i18n/fr.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Continuer →",
   acceptInstallBtn: "✓ Accepter et Installer",
   okDoneBtn: "✓  OK — Terminé",
+  doneCustomizeBtn: "✓  Terminé - Personnaliser plus",
+  doneQuitBtn: "✕  Terminé - Quitter",
   editInstallBtn: "Modifier",
   musicDisabledMsg: "Musique désactivée. L'activer maintenant ?",
   settingsFooter: "[↑↓] Groupe  [←→] Sibling/Sub-tab  [Enter/Space] Activer  [Tab] Changer Tab  [Q] Quitter",

package/src/i18n/hi.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "जारी रखें →",
   acceptInstallBtn: "✓ स्वीकार करें और स्थापित करें",
   okDoneBtn: "✓  OK — हो गया",
+  doneCustomizeBtn: "✓  हो गया - और अनुकूलित करें",
+  doneQuitBtn: "✕  हो गया - बाहर निकलें",
   editInstallBtn: "संपादित करें",
   musicDisabledMsg: "संगीत अक्षम है। अभी सक्षम करें?",
   settingsFooter: "[↑↓] समूह  [←→] सहोदर/उप-टैब  [Enter/Space] सक्रिय करें  [Tab] टैब बदलें  [Q] बाहर",

package/src/i18n/ja.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "続ける →",
   acceptInstallBtn: "✓ 承認してインストール",
   okDoneBtn: "✓  OK — 終了",
+  doneCustomizeBtn: "✓  終了 - さらにカスタマイズ",
+  doneQuitBtn: "✕  終了 - 終了する",
   editInstallBtn: "編集",
   musicDisabledMsg: "音楽が無効です。今すぐ有効にしますか？",
   settingsFooter: "[↑↓] グループ  [←→] 兄弟/サブタブ  [Enter/Space] 実行  [Tab] タブ切替  [Q] 終了",

package/src/i18n/ko.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "계속 →",
   acceptInstallBtn: "✓ 수락 및 설치",
   okDoneBtn: "✓  OK — 완료",
+  doneCustomizeBtn: "✓  완료 - 더 맞춤 설정",
+  doneQuitBtn: "✕  완료 - 종료",
   editInstallBtn: "편집",
   musicDisabledMsg: "음악이 비활성화되어 있습니다. 지금 활성화하겠습니까?",
   settingsFooter: "[↑↓] 그룹  [←→] 형제/서브탭  [Enter/Space] 활성화  [Tab] 탭 전환  [Q] 나가기",

package/src/i18n/pt.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Continuar →",
   acceptInstallBtn: "✓ Aceitar e Instalar",
   okDoneBtn: "✓  OK — Concluído",
+  doneCustomizeBtn: "✓  Concluído - Personalizar mais",
+  doneQuitBtn: "✕  Concluído - Sair",
   editInstallBtn: "Editar",
   musicDisabledMsg: "Música desativada. Ativar agora?",
   settingsFooter: "[↑↓] Grupo  [←→] Irmão/Sub-tab  [Enter/Space] Ativar  [Tab] Trocar Tab  [Q] Sair",

package/src/i18n/zh-CN.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "继续 →",
   acceptInstallBtn: "✓ 接受并安装",
   okDoneBtn: "✓  OK — 完成",
+  doneCustomizeBtn: "✓  完成 - 更多自定义",
+  doneQuitBtn: "✕  完成 - 退出",
   editInstallBtn: "编辑",
   musicDisabledMsg: "音乐已禁用。现在启用？",
   settingsFooter: "[↑↓] 组  [←→] 兄弟/子标签  [Enter/Space] 激活  [Tab] 切换标签  [Q] 退出",