agentvibes 5.7.4 → 5.7.5

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

@@ -1 +1 @@
-20260512
+20260513

package/.claude/hooks/play-tts-ssh-remote.sh

@@ -17,6 +17,7 @@ set -euo pipefail
 TEXT="${1:-}"
 VOICE="${2:-en_US-lessac-medium}"
 AGENT_NAME="${3:-default}"
+AGENT_PROFILE_FILE="${4:-}"
 
 # LLM identity — forwarded to the remote so it can look up its own
 # audio-effects.cfg llm:<name> row for voice, reverb, music, pretext, engine.
@@ -210,6 +211,19 @@ done
 [[ -n "$LLM_BG_FILE"   ]] && BG_FILE="$LLM_BG_FILE"
 [[ -n "$LLM_BG_VOLUME" ]] && BG_VOLUME="$LLM_BG_VOLUME"
 
+# Per-agent profile (written by bmad-speak.sh) takes highest priority for music
+if [[ -n "$AGENT_PROFILE_FILE" ]] && [[ -f "$AGENT_PROFILE_FILE" ]]; then
+  _prof_track=$(_AV_PROF="$AGENT_PROFILE_FILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._AV_PROF,'utf8'));process.stdout.write(p.backgroundMusic?.track??'')}catch{process.stdout.write('')}" 2>/dev/null || true)
+  _prof_vol=$(_AV_PROF="$AGENT_PROFILE_FILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._AV_PROF,'utf8'));process.stdout.write(String(p.backgroundMusic?.volume??''))}catch{process.stdout.write('')}" 2>/dev/null || true)
+  _prof_enabled=$(_AV_PROF="$AGENT_PROFILE_FILE" node -e "try{const p=JSON.parse(require('fs').readFileSync(process.env._AV_PROF,'utf8'));process.stdout.write(String(p.backgroundMusic?.enabled??''))}catch{process.stdout.write('')}" 2>/dev/null || true)
+  if [[ "$_prof_enabled" == "true" ]] && [[ -n "$_prof_track" ]]; then
+    BG_FILE="$_prof_track"
+    if [[ "$_prof_vol" =~ ^[0-9]+$ ]]; then
+      BG_VOLUME=$(awk "BEGIN{printf \"%.2f\", ${_prof_vol}/100}")
+    fi
+  fi
+fi
+
 # Read pretext if configured
 PRETEXT=""
 PRETEXT_FILE="$PROJECT_ROOT/.agentvibes/config/pretext.txt"

package/.claude/hooks/play-tts.sh

@@ -367,7 +367,7 @@ speak_text() {
       bash "$SCRIPT_DIR/play-tts-termux-ssh.sh" "$text" "$voice"
       ;;
     ssh-remote)
-      bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$text" "$voice"
+      bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$text" "$voice" "" "${profile_file:-}"
       ;;
     agentvibes-receiver)
       bash "$SCRIPT_DIR/play-tts-agentvibes-receiver-for-voiceless-connections.sh" "$text" "$voice"
@@ -497,7 +497,7 @@ case "$ACTIVE_PROVIDER" in
     exec bash "$SCRIPT_DIR/play-tts-termux-ssh.sh" "$TEXT" "$VOICE_OVERRIDE"
     ;;
   ssh-remote)
-    exec bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$TEXT" "$VOICE_OVERRIDE"
+    exec bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$TEXT" "$VOICE_OVERRIDE" "" "${AGENT_PROFILE_FILE:-}"
     ;;
   agentvibes-receiver)
     exec bash "$SCRIPT_DIR/play-tts-agentvibes-receiver-for-voiceless-connections.sh" "$TEXT" "$VOICE_OVERRIDE"

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.7.4
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.7.5
 
 ---
 
@@ -40,7 +40,19 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, using Warp Ter
 
 ---
 
-## 🌟 NEW IN v5.7.0 — BMAD v6.6 Support + Windows Auto-Restart Watcher
+## 🌟 NEW IN v5.7.5 — TUI Button Contrast + BMAD Routing Fixes
+
+**TUI buttons:** All focused/selected buttons now show white text on dark green — grey text on light-blue is gone across all terminals and all tabs.
+
+**BMAD tab:** The ♪ voice preview indicator now appears correctly in the voice list, with a 2-second minimum display timer for SSH-remote fire-and-forget mode.
+
+**Installer pretext:** Non-interactive installs now derive the pretext from the project folder name (e.g., `"MyProject here"`) instead of always defaulting to `"Claude Code here"`.
+
+**BMAD music routing:** Per-agent background music and reverb overrides now correctly reach the SSH receiver.
+
+**TERM fix:** The TUI no longer throws a `plab_norm` error when `TERM` is a `screen-*` or `tmux-*` variant.
+
+## v5.7.0 — BMAD v6.6 Support + Windows Auto-Restart Watcher
 
 **BMAD v6.6.0:** AgentVibes now detects the new `.claude/skills/*/agents/` agent structure, correctly handles globally-installed BMAD at `~/_bmad`, and gracefully skips v6.6+ plain-Markdown agents during TTS injection instead of erroring. The BMAD tab now shows detection correctly for global installs.
 

package/RELEASE_NOTES.md

@@ -1,5 +1,41 @@
 # AgentVibes Release Notes
 
+## 🖥️ v5.7.5 — TUI Button Contrast + BMAD Routing Fixes
+
+**Released:** 2026-05-13
+
+### 🐛 TUI Button Focus: Grey Text Eliminated Across All Terminals
+
+Focused and selected buttons in the TUI (voices, music, settings, setup tabs) displayed light grey text on light-blue backgrounds in many terminals. Root cause: `bold: true` combined with a dark foreground triggers terminal "bright mode," rendering the color as grey regardless of shade.
+
+**Fix:** All button focus states now use **white text on dark green (`#2e7d32`) background** — the same high-contrast pattern already used by the Agents tab. Explicit `focus`/`blur` handlers were added to setup-tab modal buttons to prevent `attachBtnBlink` from interfering with blessed's passive `style.focus` color application.
+
+### 🐛 BMAD Tab Voice Picker ♪ Indicator Not Showing
+
+The ♪ preview indicator in the BMAD tab voice list didn't appear during preview. The Agents tab was missing `_refreshVP()` calls that the Settings tab already had. A 2-second minimum display timer now keeps the indicator visible when SSH-remote exits immediately (fire-and-forget mode).
+
+### 🐛 Non-Interactive Install: Generic Pretext Instead of Project Name
+
+Running `agentvibes install` non-interactively always set the pretext to `"Claude Code here"` regardless of project. The installer now derives a project-aware pretext from `path.basename(process.cwd())` with capitalization (e.g., `"MyProject here"`), with a safe fallback for Docker root paths.
+
+### 🐛 Global Pretext Overriding Per-Project Config
+
+`seedAllLlmDefaultsSync` was seeding project-level LLM rows with the global pretext string, causing the global `"Claude Code here"` to override per-project `tts-pretext.txt` values. Project-level rows are now seeded with empty pretexts so the per-project file takes precedence.
+
+### 🐛 `screen`/`tmux` TERM Variant Caused `plab_norm` Capability Error
+
+When `TERM` was set to a `screen-*` or `tmux-*` variant, blessed threw a `plab_norm` terminal capability error on startup. The app now overrides `TERM` to `xterm-256color` before creating the blessed screen when such a variant is detected.
+
+### 🐛 BMAD Per-Agent Music/Reverb Not Reaching SSH Receiver
+
+`play-tts.sh` was not forwarding `AGENT_PROFILE_FILE` to the SSH remote transport, so per-agent background music and reverb overrides in the BMAD tab were silently ignored for remote audio. The profile file path is now passed as argument 4 to `play-tts-ssh-remote.sh`.
+
+### 🐛 Node 18 Compatibility: `import.meta.dirname` Replaced
+
+A test file used `import.meta.dirname`, available only in Node 21+. Replaced with the `fileURLToPath(import.meta.url)` pattern so tests run correctly on Node 18 and 20.
+
+---
+
 ## 🎭 v5.7.0 — BMAD v6.6 Support + Windows Auto-Restart Watcher
 
 **Released:** 2026-05-11

package/package.json

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

@@ -138,7 +138,14 @@ export class AgentVibesConsole {
       return;
     }
 
+    // blessed's terminfo parser chokes on screen-256color's plab_norm capability.
+    // xterm-256color is functionally identical for our TUI and parses cleanly.
+    const _origTerm = process.env.TERM;
+    if (/^(screen|tmux)(-256color)?$/.test(process.env.TERM || '')) {
+      process.env.TERM = 'xterm-256color';
+    }
     this.screen = blessed.screen(this._screenOptions);
+    if (_origTerm !== undefined) process.env.TERM = _origTerm;
 
     // Reflow on terminal resize
     this.screen.on('resize', () => this.screen.render());

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

@@ -367,7 +367,7 @@ ${_tl('bmadDesc')}
       padding: { left: 1, right: 1 },
       style: {
         bg: COLORS.btnDefault,
-        fg: 'white',
+        fg: 'bright-white',
         focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
       },
@@ -711,7 +711,7 @@ ${_tl('bmadDesc')}
         padding: { left: 1, right: 1 },
         style: {
           bg: COLORS.btnDefault,
-          fg: 'white',
+          fg: 'bright-white',
           focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
           hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         },
@@ -1139,8 +1139,6 @@ ${_tl('bmadDesc')}
     const inputBox = blessed.textbox({
       parent: editModal, top: 3, left: 2, right: 2, height: 3,
       border: { type: 'line' },
-      inputOnFocus: true,
-      value: draft.pretext,
       style: {
         fg: COLORS.valueFg, bg: '#0d1b35',
         border: { fg: COLORS.borderFg },
@@ -1149,22 +1147,78 @@ ${_tl('bmadDesc')}
     });
 
     let _editClosed = false;
+    let _cursor = draft.pretext.length;
+    inputBox.value = draft.pretext;
+
+    function _renderPretext() {
+      const val = inputBox.value;
+      const lpos = inputBox._getCoords();
+      if (!lpos) { screen.render(); return; }
+      const contentWidth = Math.max(1, (lpos.xl - lpos.xi) - inputBox.iwidth);
+      const start = _cursor > contentWidth - 1 ? _cursor - contentWidth + 1 : 0;
+      inputBox.setContent(val.slice(start));
+      screen.render();
+      screen.program.cup(lpos.yi + inputBox.itop, lpos.xi + inputBox.ileft + (_cursor - start));
+    }
+
+    const _prevGrabKeys = screen.grabKeys;
     function _closeEdit(save) {
       if (_editClosed) return;
       _editClosed = true;
+      inputBox.removeAllListeners('keypress');
+      screen.grabKeys = _prevGrabKeys;
+      screen.program.hideCursor();
       if (save) {
-        const raw = inputBox.getValue().trim();
-        // M7: enforce max pretext length
-        draft.pretext = (raw || draft.pretext).slice(0, MAX_PRETEXT_LENGTH);
+        // M7: enforce max pretext length; allow clearing to empty string
+        draft.pretext = inputBox.value.trim().slice(0, MAX_PRETEXT_LENGTH);
       }
       destroyList(editModal, screen, onDone);
     }
 
-    inputBox.key(['enter'], () => _closeEdit(true));
-    inputBox.key(['escape'], () => _closeEdit(false));
+    // Guard: if editModal is destroyed externally (parent closed, signal, etc.)
+    // without _closeEdit being called, restore grab state so TUI stays responsive.
+    editModal.once('destroy', () => {
+      if (!_editClosed) {
+        _editClosed = true;
+        inputBox.removeAllListeners('keypress');
+        screen.grabKeys = _prevGrabKeys;
+        screen.program.hideCursor();
+      }
+    });
 
+    screen.grabKeys = true;
     inputBox.focus();
-    screen.render();
+    screen.render(); // Layout pass so _getCoords() returns valid coords on first _renderPretext
+    screen.program.showCursor();
+    _renderPretext();
+
+    inputBox.on('keypress', function(ch, key) {
+      if (_editClosed) return;
+      const val = inputBox.value;
+      if (key.name === 'enter') { _closeEdit(true); return; }
+      if (key.name === 'escape') { _closeEdit(false); return; }
+      if (key.name === 'home' || (key.ctrl && key.name === 'a')) {
+        _cursor = 0;
+      } else if (key.name === 'end' || (key.ctrl && key.name === 'e')) {
+        _cursor = val.length;
+      } else if (key.name === 'left') {
+        if (_cursor > 0) _cursor--; else return;
+      } else if (key.name === 'right') {
+        if (_cursor < val.length) _cursor++; else return;
+      } else if (key.name === 'backspace') {
+        if (_cursor > 0) { inputBox.value = val.slice(0, _cursor - 1) + val.slice(_cursor); _cursor--; }
+        else return;
+      } else if (key.name === 'delete') {
+        if (_cursor < val.length) { inputBox.value = val.slice(0, _cursor) + val.slice(_cursor + 1); }
+        else return;
+      } else if (ch && !key.ctrl && !key.meta && !/^[\x00-\x08\x0b-\x0c\x0e-\x1f\x7f]$/.test(ch)) {
+        inputBox.value = val.slice(0, _cursor) + ch + val.slice(_cursor);
+        _cursor++;
+      } else {
+        return;
+      }
+      _renderPretext();
+    });
   }
 
   // -------------------------------------------------------------------------

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

@@ -409,7 +409,7 @@ export function createMusicTab(screen, services) {
       padding: { left: 1, right: 1 },
       style: {
         bg: COLORS.btnDefault,
-        fg: 'white',
+        fg: 'bright-white',
         focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
       },
@@ -423,7 +423,7 @@ export function createMusicTab(screen, services) {
     });
     btn.on('blur', () => {
       btn.style.bg = COLORS.btnDefault;
-      btn.style.fg = 'white';
+      btn.style.fg = 'bright-white';
       const raw = btn.content.replace(/[►◄]/g, '').trim();
       btn.setContent(raw);
       screen.render();
@@ -776,7 +776,7 @@ export function createMusicTab(screen, services) {
         padding: { left: 1, right: 1 },
         style: {
           bg,
-          fg: 'white',
+          fg: 'bright-white',
           focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
           hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         },
@@ -819,7 +819,7 @@ export function createMusicTab(screen, services) {
       padding: { left: 1, right: 1 },
       style: {
         bg: '#e65100',
-        fg: 'white',
+        fg: 'bright-white',
         focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
       },

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

@@ -583,7 +583,7 @@ export function createSettingsTab(screen, services) {
       style: {
         fg: COLORS.labelFg, bg: COLORS.contentBg,
         border: { fg: 'blue' },
-        selected: { bg: 'green', fg: 'white', bold: true },
+        selected: { bg: 'green', fg: 'black', bold: true },
         item: { fg: COLORS.labelFg },
       },
     });

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

@@ -78,7 +78,7 @@ const COLORS = {
   noticeFg:   'white',
   btnBg:      'blue',
   btnFg:      'white',
-  btnFocusBg: 'cyan',
+  btnFocusBg: '#2e7d32',
   removeBg:   'red',
   removeFocusBg: 'magenta',
   cfgBg:      'green',
@@ -354,7 +354,7 @@ export function createSetupTab(screen, services) {
       content: '  Install  ', tags: true, mouse: true, keys: true, hidden: true,
       style: {
         fg: COLORS.btnFg, bg: COLORS.btnBg,
-        focus: { fg: 'black', bg: COLORS.btnFocusBg },
+        focus: { fg: 'white', bg: COLORS.btnFocusBg },
       },
     });
 
@@ -534,7 +534,7 @@ export function createSetupTab(screen, services) {
       style: {
         fg: COLORS.btnFg,
         bg: COLORS.btnBg,
-        focus: { fg: 'black', bg: COLORS.btnFocusBg },
+        focus: { fg: 'white', bg: COLORS.btnFocusBg },
       },
     });
 
@@ -870,10 +870,12 @@ export function createSetupTab(screen, services) {
         padding: { left: 1, right: 1 },
         style: {
           bg: 'blue', fg: 'white',
-          focus: { bg: 'cyan', fg: 'black', bold: true },
-          hover: { bg: 'cyan', fg: 'black', bold: true },
+          focus: { bg: '#2e7d32', fg: 'white', bold: true },
+          hover: { bg: '#2e7d32', fg: 'white', bold: true },
         },
       });
+      btn.on('focus', () => { btn.style.bg = '#2e7d32'; btn.style.fg = 'white'; screen.render(); });
+      btn.on('blur',  () => { btn.style.bg = 'blue';    btn.style.fg = 'white'; screen.render(); });
       btn.key(['enter', 'space'], () => onClick());
       btn.on('click', () => onClick());
       return btn;
@@ -1115,7 +1117,7 @@ export function createSetupTab(screen, services) {
       style: {
         fg: COLORS.labelFg, bg: COLORS.contentBg,
         border: { fg: 'cyan' },
-        selected: { bg: 'blue', fg: 'white', bold: true },
+        selected: { bg: 'blue', fg: 'black', bold: true },
       },
     });
     picker.setFront();
@@ -1154,7 +1156,7 @@ export function createSetupTab(screen, services) {
       style: {
         fg: COLORS.labelFg, bg: COLORS.contentBg,
         border: { fg: 'cyan' },
-        selected: { bg: 'blue', fg: 'white', bold: true },
+        selected: { bg: 'blue', fg: 'black', bold: true },
       },
     });
     picker.setFront();
@@ -1268,7 +1270,7 @@ export function createSetupTab(screen, services) {
       style: {
         fg: COLORS.labelFg, bg: COLORS.contentBg,
         border: { fg: 'cyan' },
-        selected: { bg: 'blue', fg: 'white', bold: true },
+        selected: { bg: 'blue', fg: 'black', bold: true },
       },
     });
     picker.setFront();
@@ -1326,7 +1328,7 @@ export function createSetupTab(screen, services) {
       style: {
         fg: COLORS.labelFg, bg: COLORS.contentBg,
         border: { fg: 'cyan' },
-        selected: { bg: 'blue', fg: 'white', bold: true },
+        selected: { bg: 'blue', fg: 'black', bold: true },
       },
     });
     picker.setFront();
@@ -1364,7 +1366,7 @@ export function createSetupTab(screen, services) {
       style: {
         fg: COLORS.labelFg, bg: COLORS.contentBg,
         border: { fg: 'cyan' },
-        selected: { bg: 'blue', fg: 'white', bold: true },
+        selected: { bg: 'blue', fg: 'black', bold: true },
       },
     });
     picker.setFront();
@@ -1400,7 +1402,7 @@ export function createSetupTab(screen, services) {
       style: {
         fg: COLORS.labelFg, bg: COLORS.contentBg,
         border: { fg: 'cyan' },
-        selected: { bg: 'blue', fg: 'white', bold: true },
+        selected: { bg: 'blue', fg: 'black', bold: true },
       },
     });
     picker.setFront();
@@ -1501,10 +1503,12 @@ export function createSetupTab(screen, services) {
         padding: { left: 1, right: 1 },
         style: {
           bg: 'blue', fg: 'white',
-          focus: { bg: 'cyan', fg: 'black', bold: true },
-          hover: { bg: 'cyan', fg: 'black', bold: true },
+          focus: { bg: '#2e7d32', fg: 'white', bold: true },
+          hover: { bg: '#2e7d32', fg: 'white', bold: true },
         },
       });
+      btn.on('focus', () => { btn.style.bg = '#2e7d32'; btn.style.fg = 'white'; screen.render(); });
+      btn.on('blur',  () => { btn.style.bg = 'blue';    btn.style.fg = 'white'; screen.render(); });
       btn.key(['enter', 'space'], () => onClick());
       btn.on('click', () => onClick());
       return btn;
@@ -1618,11 +1622,15 @@ export function createSetupTab(screen, services) {
     let _closed = false;
     navigationService?.openModal(null, _closeModal);
 
+    const _folderName = path.basename(targetDir);
+    const _folderPretext = _folderName
+      ? _folderName.charAt(0).toUpperCase() + _folderName.slice(1) + ' here'
+      : '';
     const defaultPretext = {
-      'claude-code': 'Claude Code here',
-      'copilot': 'Copilot here',
-      'codex': 'Codex here',
-      'default': path.basename(targetDir),  // default to project folder name
+      'claude-code': _folderPretext,
+      'copilot':     _folderPretext,
+      'codex':       _folderPretext,
+      'default':     _folderPretext,
     };
 
     // Read global defaults for display
@@ -1747,10 +1755,12 @@ export function createSetupTab(screen, services) {
         style: {
           bg: 'blue',
           fg: 'white',
-          focus: { bg: 'cyan', fg: 'black', bold: true },
-          hover: { bg: 'cyan', fg: 'black', bold: true },
+          focus: { bg: '#2e7d32', fg: 'white', bold: true },
+          hover: { bg: '#2e7d32', fg: 'white', bold: true },
         },
       });
+      btn.on('focus', () => { btn.style.bg = '#2e7d32'; btn.style.fg = 'white'; screen.render(); });
+      btn.on('blur',  () => { btn.style.bg = 'blue';    btn.style.fg = 'white'; screen.render(); });
       btn.key(['enter', 'space'], () => onClick());
       btn.on('click', () => onClick());
       return btn;
@@ -2172,7 +2182,7 @@ export function createSetupTab(screen, services) {
       style: {
         fg: COLORS.labelFg, bg: COLORS.contentBg,
         border: { fg: 'blue' },
-        selected: { bg: 'green', fg: 'white', bold: true },
+        selected: { bg: 'green', fg: 'black', bold: true },
         item: { fg: COLORS.labelFg },
       },
     });
@@ -2431,8 +2441,6 @@ export function createSetupTab(screen, services) {
     const inputBox = blessed.textbox({
       parent: editModal, top: 3, left: 2, right: 2, height: 3,
       border: { type: 'line' },
-      inputOnFocus: true,
-      value: draft.pretext,
       style: {
         fg: 'white', bg: 'black',
         border: { fg: 'blue' },
@@ -2440,21 +2448,79 @@ export function createSetupTab(screen, services) {
       },
     });
 
+    let _editClosed = false;
+    let _cursor = (draft.pretext || '').length;
+    inputBox.value = draft.pretext || '';
+
+    function _renderPretext() {
+      const val = inputBox.value;
+      const lpos = inputBox._getCoords();
+      if (!lpos) { screen.render(); return; }
+      const contentWidth = Math.max(1, (lpos.xl - lpos.xi) - inputBox.iwidth);
+      const start = _cursor > contentWidth - 1 ? _cursor - contentWidth + 1 : 0;
+      inputBox.setContent(val.slice(start));
+      screen.render();
+      screen.program.cup(lpos.yi + inputBox.itop, lpos.xi + inputBox.ileft + (_cursor - start));
+    }
+
+    const _prevGrabKeys = screen.grabKeys;
     function _closeEdit(save) {
+      if (_editClosed) return;
+      _editClosed = true;
+      inputBox.removeAllListeners('keypress');
+      screen.grabKeys = _prevGrabKeys;
+      screen.program.hideCursor();
       if (save) {
-        const val = (inputBox.getValue() || '').trim().slice(0, 200);
-        draft.pretext = val;
+        draft.pretext = (inputBox.value || '').trim().slice(0, 200);
       }
       destroyList(editModal, screen);
       onDone();
     }
 
-    inputBox.key(['enter'], () => _closeEdit(true));
-    inputBox.key(['escape'], () => _closeEdit(false));
+    // Guard: if editModal is destroyed externally without _closeEdit being called,
+    // restore grab state so TUI stays responsive.
+    editModal.once('destroy', () => {
+      if (!_editClosed) {
+        _editClosed = true;
+        inputBox.removeAllListeners('keypress');
+        screen.grabKeys = _prevGrabKeys;
+        screen.program.hideCursor();
+      }
+    });
 
+    screen.grabKeys = true;
     inputBox.focus();
-    inputBox.readInput(() => {});
-    screen.render();
+    screen.render(); // Layout pass so _getCoords() returns valid coords on first _renderPretext
+    screen.program.showCursor();
+    _renderPretext();
+
+    inputBox.on('keypress', function(ch, key) {
+      if (_editClosed) return;
+      const val = inputBox.value;
+      if (key.name === 'enter') { _closeEdit(true); return; }
+      if (key.name === 'escape') { _closeEdit(false); return; }
+      if (key.name === 'home' || (key.ctrl && key.name === 'a')) {
+        _cursor = 0;
+      } else if (key.name === 'end' || (key.ctrl && key.name === 'e')) {
+        _cursor = val.length;
+      } else if (key.name === 'left') {
+        if (_cursor > 0) _cursor--; else return;
+      } else if (key.name === 'right') {
+        if (_cursor < val.length) _cursor++; else return;
+      } else if (key.name === 'backspace') {
+        if (_cursor > 0) { inputBox.value = val.slice(0, _cursor - 1) + val.slice(_cursor); _cursor--; }
+        else return;
+      } else if (key.name === 'delete') {
+        if (_cursor < val.length) { inputBox.value = val.slice(0, _cursor) + val.slice(_cursor + 1); }
+        else return;
+      } else if (ch && !key.ctrl && !key.meta && !/^[\x00-\x08\x0b-\x0c\x0e-\x1f\x7f]$/.test(ch)) {
+        inputBox.value = val.slice(0, _cursor) + ch + val.slice(_cursor);
+        _cursor++;
+      } else {
+        return;
+      }
+      _renderPretext();
+    });
   }
 
   // ── Saved toast ───────────────────────────────────────────────────────────

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

@@ -1122,7 +1122,7 @@ export function createVoicesTab(screen, services) {
       padding: { left: 1, right: 1 },
       style: {
         bg: COLORS.btnDefault,
-        fg: 'white',
+        fg: 'bright-white',
         focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
       },
@@ -1136,7 +1136,7 @@ export function createVoicesTab(screen, services) {
     });
     btn.on('blur', () => {
       btn.style.bg = COLORS.btnDefault;
-      btn.style.fg = 'white';
+      btn.style.fg = 'bright-white';
       const raw = btn.content.replace(/[►◄]/g, '').trim();
       btn.setContent(raw);
       screen.render();
@@ -1306,7 +1306,7 @@ export function createVoicesTab(screen, services) {
         padding: { left: 1, right: 1 },
         style: {
           bg,
-          fg: 'white',
+          fg: 'bright-white',
           focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
           hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         },
@@ -1341,7 +1341,7 @@ export function createVoicesTab(screen, services) {
       padding: { left: 1, right: 1 },
       style: {
         bg: '#e65100',
-        fg: 'white',
+        fg: 'bright-white',
         focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
       },
@@ -1550,7 +1550,7 @@ export function createVoicesTab(screen, services) {
         padding: { left: 1, right: 1 },
         style: {
           bg,
-          fg: 'white',
+          fg: 'bright-white',
           focus: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
           hover: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
         },

package/src/installer.js

@@ -74,6 +74,7 @@ import { promptForCustomMusic } from './installer/music-file-input.js';
 import { createPreviewListPrompt } from './utils/preview-list-prompt.js';
 import { selectLanguage } from './installer/language-screen.js';
 import { t } from './i18n/strings.js';
+import { seedAllLlmDefaultsSync } from './services/llm-provider-service.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -1248,12 +1249,20 @@ async function collectConfiguration(options = {}) {
       config.provider = process.platform === 'darwin' ? 'macos' : 'piper';
       config.defaultVoice = process.platform === 'darwin' ? 'Samantha' : 'en_US-ryan-high';
     }
-    const homeDir = process.env.HOME || process.env.USERPROFILE;
+    const homeDir = process.env.HOME || process.env.USERPROFILE || os.homedir();
     config.piperPath = path.join(homeDir, '.claude', 'piper-voices');
     // AI agent / non-interactive defaults: no reverb, no background music, no hermes
     config.reverb = 'none';
     config.backgroundMusic = { enabled: false, track: 'agentvibes_soft_flamenco_loop.mp3' };
     config.hermes = { enabled: false };
+    // Use folder name as project identity when no existing pretext is set
+    if (!config.pretext) {
+      const folderName = path.basename(process.cwd());
+      // Guard empty basename (e.g. process.cwd() === '/' in some Docker containers)
+      if (folderName) {
+        config.pretext = folderName.charAt(0).toUpperCase() + folderName.slice(1) + ' here';
+      }
+    }
     return config;
   }
 
@@ -5761,6 +5770,11 @@ Troubleshooting:
     }
     // Do NOT unlink tts-pretext.txt when blank — user may have set it via MCP or manually.
 
+    // Seed project-level llm: rows with empty pretext so global ~/.claude/config/audio-effects.cfg
+    // "Claude Code here" rows don't override tts-pretext.txt (play-tts.sh stops searching when it
+    // finds a row with a voice, then falls through to tts-pretext.txt for the pretext).
+    seedAllLlmDefaultsSync(targetDir);
+
     // Apply reverb setting
     const selectedReverb = userConfig.reverb;
     if (selectedReverb && selectedReverb !== 'off') {

package/src/services/llm-provider-service.js

@@ -59,7 +59,7 @@ const DEFAULT_LLM_CONFIGS = {
     bgTrack: 'agent_vibes_chillwave_v2_loop.mp3',
     bgVolume: '0.15',
     voice: 'en_US-lessac-high',
-    pretext: 'Claude Code here',
+    pretext: '',
     ttsEngine: 'piper',
   },
   copilot: {
@@ -67,7 +67,7 @@ const DEFAULT_LLM_CONFIGS = {
     bgTrack: 'agent_vibes_bossa_nova_v2_loop.mp3',
     bgVolume: '0.15',
     voice: 'en_US-libritts-high::Anna-11',
-    pretext: 'Copilot here',
+    pretext: '',
     ttsEngine: 'piper',
   },
   codex: {
@@ -78,7 +78,7 @@ const DEFAULT_LLM_CONFIGS = {
     // Windows Piper installs (loads the model, exits with no output).
     // lessac-high works reliably, so use it as the default for codex.
     voice: 'en_US-lessac-high',
-    pretext: 'Codex here',
+    pretext: '',
     ttsEngine: 'piper',
   },
   hermes: {
@@ -86,7 +86,7 @@ const DEFAULT_LLM_CONFIGS = {
     bgTrack: 'agent_vibes_bachata_v1_loop.mp3',
     bgVolume: '0.15',
     voice: 'en_US-libritts-high::Leo-8',
-    pretext: 'Hermes here',
+    pretext: '',
     ttsEngine: 'piper',
   },
 };