agentvibes 4.0.1 → 4.4.0

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

@@ -32,11 +32,11 @@ const COLORS = {
   sectionHdr: '#00897b',  // Teal — section headers for Voices tab
   labelFg:    '#e3f2fd',
   valueFg:    '#f06292',  // Light magenta — brand color
-  activeFg:   '#00e5ff',  // Cyan — active voice
+  activeFg:   'bright-cyan',  // Cyan — active voice
   favoriteFg: '#ffff00',  // Yellow — favorite star
   btnDefault: '#00695c',  // Teal — Voices tab buttons
-  btnFocus:   '#00e5ff',
-  btnFocusFg: '#000000',
+  btnFocus:   '#2e7d32',  // Green — focused/selected
+  btnFocusFg: '#ffffff',
   btnPress:   '#ff00ff',
   borderFg:   '#00897b',
   footerBg:   '#00695c',  // Teal — Voices tab footer
@@ -513,7 +513,7 @@ export function createVoicesTab(screen, services) {
     keys: true,
     style: {
       fg: COLORS.valueFg,
-      bg: '#1a237e',
+      bg: '#1a3a5c',
       focus: { bg: '#283593' },
     },
   });
@@ -549,7 +549,7 @@ export function createVoicesTab(screen, services) {
       fg: COLORS.labelFg,
       bg: COLORS.contentBg,
       border: { fg: COLORS.borderFg },
-      selected: { bg: '#1a237e', fg: COLORS.activeFg, bold: true },
+      selected: { bg: '#2e7d32', fg: '#ffffff', bold: true },
       item: { fg: COLORS.labelFg },
     },
   });
@@ -670,12 +670,24 @@ export function createVoicesTab(screen, services) {
     const tempWav = path.join(os.tmpdir(), `agentvibes-preview-${Date.now()}.wav`);
     const phrase = SAMPLE_PHRASES[Math.floor(Math.random() * SAMPLE_PHRASES.length)];
 
-    // Synthesize: spawn piper in its own process group; pass text via stdin with newline
+    // Synthesize: spawn piper; on Windows use the exe path directly
+    const isWindows = process.platform === 'win32' && !process.env.WSL_DISTRO_NAME;
+    let piperBin = 'piper';
+    if (isWindows) {
+      const localAppData = process.env.LOCALAPPDATA ||
+        (process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'AppData', 'Local') : null);
+      if (localAppData) {
+        const exePath = path.join(localAppData, 'Programs', 'Piper', 'piper.exe');
+        if (fs.existsSync(exePath)) piperBin = exePath;
+      }
+    }
     const piperArgs = ['--model', voicePath, '--output_file', tempWav];
     if (ms.speakerId != null) piperArgs.push('--speaker', String(ms.speakerId));
-    const piper = spawn('piper', piperArgs, {
+    // On Windows, avoid detached:true which opens a visible console window
+    const piper = spawn(piperBin, piperArgs, {
       stdio: ['pipe', 'ignore', 'ignore'],
-      detached: true,
+      detached: !isWindows,
+      windowsHide: true,
       env: _spawnEnv,
     });
     piper.stdin.write(phrase + '\n');
@@ -716,7 +728,8 @@ export function createVoicesTab(screen, services) {
       }
       const playProc = spawn(_wavP.bin, _wavP.args(tempWav), {
         stdio: 'ignore',
-        detached: true,
+        detached: !isWindows,
+        windowsHide: true,
         env: _spawnEnv,
       });
       // Race note: _playingVoiceId could change between piper exit and here
@@ -993,7 +1006,7 @@ export function createVoicesTab(screen, services) {
       refreshDisplay();
       _showVoiceChangedNotice(displayName);
     });
-    const okGlobalBtn = _makeBtn('Save Globally & Locally', '#2e7d32', 18, 5, () => {
+    const okGlobalBtn = _makeBtn('Save Globally & Locally', '#1565c0', 18, 5, () => {
       _activateVoice(voiceId);
       _activateVoiceGlobal(voiceId);
       refreshDisplay();
@@ -1100,26 +1113,91 @@ export function createVoicesTab(screen, services) {
     function _startDownload() {
       if (_downloading) return;
       _downloading = true;
-      statusLine.setContent(`{${COLORS.activeFg}-fg}⬇ Downloading ${modelToDownload}…{/${COLORS.activeFg}-fg}`);
-      screen.render();
 
-      // Use piper-voice-manager.sh download_voice function
-      const managerScript = path.resolve(process.cwd(), '.claude', 'hooks', 'piper-voice-manager.sh');
-      const dlProc = spawn('bash', ['-c', 'source "$1" && download_voice "$2"', '_', managerScript, modelToDownload], {
-        stdio: ['ignore', 'pipe', 'pipe'],
-        env: _spawnEnv,
-      });
+      // Animated spinner
+      const spinFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+      let spinIdx = 0;
+      let dlPhase = 'Downloading model';
+      const progressBar = (pct) => {
+        const filled = Math.round(pct / 5);
+        const empty = 20 - filled;
+        return '█'.repeat(filled) + '░'.repeat(empty);
+      };
+
+      const spinTimer = setInterval(() => {
+        spinIdx = (spinIdx + 1) % spinFrames.length;
+        const frame = spinFrames[spinIdx];
+        statusLine.setContent(
+          `{${COLORS.activeFg}-fg}${frame} ${dlPhase}… ${modelToDownload}{/${COLORS.activeFg}-fg}`
+        );
+        screen.render();
+      }, 100);
+
+      // Download voice model — use PowerShell on Windows, bash on Unix
+      const packageRoot = path.resolve(__dirname, '..', '..', '..');
+      const isWindows = process.platform === 'win32' && !process.env.WSL_DISTRO_NAME;
+      let dlProc;
+
+      if (isWindows) {
+        const piperVoicesDir = resolvePiperVoicesDir();
+        const hfBase = 'https://huggingface.co/rhasspy/piper-voices/resolve/main';
+        const match = modelToDownload.match(/^([a-z]{2})_([A-Z]{2})-([a-zA-Z0-9_]+)-([a-z]+)$/);
+        let modelUrl, configUrl;
+        if (match) {
+          const [, lang, region, speaker, quality] = match;
+          const hfPath = `${lang}/${lang}_${region}/${speaker}/${quality}`;
+          modelUrl = `${hfBase}/${hfPath}/${modelToDownload}.onnx`;
+          configUrl = `${hfBase}/${hfPath}/${modelToDownload}.onnx.json`;
+        } else {
+          const customBase = 'https://huggingface.co/agentvibes/piper-custom-voices/resolve/main';
+          modelUrl = `${customBase}/${modelToDownload}.onnx`;
+          configUrl = `${customBase}/${modelToDownload}.onnx.json`;
+        }
+        const modelFile = path.join(piperVoicesDir, `${modelToDownload}.onnx`);
+        const configFile = path.join(piperVoicesDir, `${modelToDownload}.onnx.json`);
+        // PowerShell script with progress reporting
+        const psScript = `
+          $ErrorActionPreference = 'Stop'
+          $ProgressPreference = 'SilentlyContinue'
+          $voicesDir = '${piperVoicesDir.replace(/'/g, "''")}'
+          if (-not (Test-Path $voicesDir)) { New-Item -ItemType Directory -Path $voicesDir -Force | Out-Null }
+          Write-Output 'PHASE:model'
+          Invoke-WebRequest -Uri '${modelUrl}' -OutFile '${modelFile.replace(/'/g, "''")}' -ErrorAction Stop
+          Write-Output 'PHASE:config'
+          Invoke-WebRequest -Uri '${configUrl}' -OutFile '${configFile.replace(/'/g, "''")}' -ErrorAction Stop
+          Write-Output 'PHASE:done'
+        `;
+        dlProc = spawn('powershell', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', psScript], {
+          stdio: ['ignore', 'pipe', 'pipe'],
+          env: _spawnEnv,
+        });
+      } else {
+        const managerScript = path.resolve(packageRoot, '.claude', 'hooks', 'piper-voice-manager.sh');
+        dlProc = spawn('bash', ['-c', 'source "$1" && download_voice "$2"', '_', managerScript, modelToDownload], {
+          stdio: ['ignore', 'pipe', 'pipe'],
+          env: _spawnEnv,
+        });
+      }
       _downloadProcess = dlProc;
 
       let output = '';
-      dlProc.stdout.on('data', (d) => { output += d.toString(); });
+      dlProc.stdout.on('data', (d) => {
+        const chunk = d.toString();
+        output += chunk;
+        // Update phase based on progress markers
+        if (chunk.includes('PHASE:config') || chunk.includes('config file')) {
+          dlPhase = 'Downloading config';
+        } else if (chunk.includes('PHASE:done') || chunk.includes('successfully')) {
+          dlPhase = 'Finishing up';
+        }
+      });
       dlProc.stderr.on('data', (d) => { output += d.toString(); });
 
       dlProc.on('exit', (code) => {
+        clearInterval(spinTimer);
         _downloading = false;
         _downloadProcess = null;
         if (code === 0) {
-          // Patch speaker names for freshly downloaded LibriTTS model
           if (isLibriTTS) {
             patchLibriTTSSpeakerNames();
             _metaCache.clear();
@@ -1137,6 +1215,7 @@ export function createVoicesTab(screen, services) {
       });
 
       dlProc.on('error', () => {
+        clearInterval(spinTimer);
         _downloading = false;
         _downloadProcess = null;
         statusLine.setContent(`{red-fg}✗ Could not run download script{/red-fg}`);
@@ -1235,7 +1314,7 @@ export function createVoicesTab(screen, services) {
         // Greyed-out row for uninstalled catalog voices
         return `{bright-black-fg} ${star}  ${name}${gender.padEnd(COL_GENDER_W)}${provider}{/bright-black-fg}`;
       }
-      return ` ${star}${dot} ${name}${gender.padEnd(COL_GENDER_W)}${provider}${isPrev ? ' (playing)' : ''}`;
+      return `{${COLORS.labelFg}-fg} ${star}${dot} ${name}${gender.padEnd(COL_GENDER_W)}${provider}${isPrev ? ' (playing)' : ''}{/${COLORS.labelFg}-fg}`;
     });
   }
 

package/src/console/widgets/destroy-list.js

@@ -0,0 +1,25 @@
+/**
+ * AgentVibes TUI — Shared Widget: Modal Destroy Helper
+ *
+ * Force-invalidates blessed's olines buffer after destroying a modal widget.
+ * Without this, blessed skips repainting cells where lines==olines and the
+ * terminal retains stale modal content as ghost artifacts.
+ */
+
+/**
+ * Destroy a blessed list/box widget and force full screen repaint.
+ *
+ * @param {object} widget  - blessed widget to destroy
+ * @param {object} screen  - blessed screen instance
+ * @param {Function} [onClose] - optional callback after destruction
+ */
+export function destroyList(widget, screen, onClose) {
+  widget.destroy();
+  try {
+    for (let r = 0; r < screen.height; r++)
+      for (let c = 0; c < screen.width; c++)
+        if (screen.olines[r]?.[c]) screen.olines[r][c][0] = -1;
+  } catch {}
+  onClose?.();
+  screen.render();
+}

package/src/console/widgets/format-utils.js

@@ -0,0 +1,89 @@
+/**
+ * AgentVibes TUI — Shared Format Utilities
+ *
+ * Pure formatting functions extracted from settings-tab.js to avoid
+ * circular imports between widgets and tabs.
+ */
+
+const TRACK_NAMES = Object.freeze({
+  'agentvibes_soft_flamenco_loop.mp3':                 '🎻 Soft Flamenco',
+  'agent_vibes_bachata_v1_loop.mp3':                   '🎺 Bachata',
+  'agent_vibes_salsa_v2_loop.mp3':                     '💃 Salsa',
+  'agent_vibes_cumbia_v1_loop.mp3':                    '🎸 Cumbia',
+  'agent_vibes_bossa_nova_v2_loop.mp3':                '🌸 Bossa Nova',
+  'agent_vibes_japanese_city_pop_v1_loop.mp3':         '🌆 Japanese City Pop',
+  'agent_vibes_chillwave_v2_loop.mp3':                 '🌊 Chillwave',
+  'agent_vibes_dark_chill_step_loop.mp3':              '🌙 Dark Chill Step',
+  'agent_vibes_goa_trance_v2_loop.mp3':                '🌀 Goa Trance',
+  'agent_vibes_harpsichord_v2_loop.mp3':               '🎼 Harpsichord',
+  'agent_vibes_celtic_harp_v1_loop.mp3':               '🎻 Celtic Harp',
+  'agent_vibes_hawaiian_slack_key_guitar_v2_loop.mp3': '🌺 Hawaiian Slack Key Guitar',
+  'agent_vibes_arabic_v2_loop.mp3':                    '🎵 Arabic Oud',
+  'agent_vibes_ganawa_ambient_v2_loop.mp3':            '🪘 Gnawa Ambient',
+  'agent_vibes_tabla_dream_pop_v1_loop.mp3':           '🥁 Tabla Dream Pop',
+});
+
+/**
+ * @param {string} track - filename (e.g. 'agentvibes_soft_flamenco_loop.mp3')
+ * @returns {string}
+ */
+export function formatTrackName(track) {
+  if (!track) return 'None';
+  if (TRACK_NAMES[track]) return TRACK_NAMES[track];
+  return track
+    .replace(/\.[^.]+$/, '')
+    .replace(/^agentvibes_|^agent_vibes_/, '')
+    .replace(/_v\d+_loop$|_loop$|_v\d+$/, '')
+    .replace(/_/g, ' ')
+    .replace(/\b\w/g, c => c.toUpperCase());
+}
+
+/**
+ * Beautify a raw voice identifier for display in narrow table columns.
+ *
+ * Examples:
+ *   16Speakers::Rose_Ibex       → Rose Ibex
+ *   16Speakers::Emily_Cripps    → Emily Cripps
+ *   en_US-kusal-medium          → Kusal
+ *   en_US-lessac-high           → Lessac
+ *   en_US-libritts_r-medium     → Libritts R
+ *   kristin                     → Kristin
+ *
+ * @param {string} voice - raw voice identifier
+ * @returns {string}
+ */
+export function formatVoiceName(voice) {
+  if (!voice) return '(global)';
+
+  let name;
+  if (voice.includes('::')) {
+    // 16Speakers::Rose_Ibex → extract after '::'
+    name = voice.split('::')[1];
+  } else {
+    const parts = voice.split('-');
+    const QUALITIES = new Set(['high', 'medium', 'low']);
+    if (parts.length >= 2 && /^[a-z]{2}_[A-Z]{2}$/.test(parts[0])) {
+      // Strip locale prefix and quality suffix
+      name = parts.slice(1).filter(p => !QUALITIES.has(p)).join(' ');
+    } else {
+      name = voice;
+    }
+  }
+
+  // Replace underscores with spaces, title-case each word
+  return name
+    .replace(/_/g, ' ')
+    .split(' ')
+    .filter(Boolean)
+    .map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+    .join(' ') || '(global)';
+}
+
+/**
+ * @param {string} preset - 'off' | 'light' | 'medium' | 'heavy' | 'cathedral'
+ * @returns {string}
+ */
+export function formatReverbState(preset) {
+  const LABELS = { off: 'Off', light: 'Light (Small room)', medium: 'Medium (Conference room)', heavy: 'Heavy (Large hall)', cathedral: 'Cathedral (Epic space)' };
+  return LABELS[preset] ?? LABELS.light;
+}

package/src/console/widgets/notice.js

@@ -0,0 +1,55 @@
+/**
+ * AgentVibes TUI — Shared Widget: Notice Toast
+ *
+ * Displays a short auto-dismissing notice modal centred on screen.
+ * Usable from any tab; no settings-specific state required.
+ */
+
+import { destroyList } from './destroy-list.js';
+
+const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
+let blessed;
+if (!IS_TEST) {
+  const { default: b } = await import('blessed');
+  blessed = b;
+}
+
+/**
+ * Show a temporary notice that auto-dismisses after 2.5 seconds.
+ *
+ * @param {object} screen  - blessed screen instance
+ * @param {string} message - text to display
+ * @param {object} [opts]
+ * @param {string} [opts.bg='#0a0e1a']       - background colour
+ * @param {string} [opts.fg='#e3f2fd']       - foreground colour
+ * @param {string} [opts.borderFg='bright-cyan'] - border colour
+ * @param {number} [opts.durationMs=2500]    - auto-dismiss delay in ms
+ */
+export function showNotice(screen, message, opts = {}) {
+  const bg         = opts.bg         ?? '#0a0e1a';
+  const fg         = opts.fg         ?? '#e3f2fd';
+  const borderFg   = opts.borderFg   ?? 'bright-cyan';
+  const durationMs = opts.durationMs ?? 2500;
+
+  const width = Math.max(28, message.length + 6);
+  const modal = blessed.box({
+    parent: screen,
+    top: 'center',
+    left: 'center',
+    width,
+    height: 3,
+    border: { type: 'line' },
+    tags: true,
+    content: `{center}${message}{/center}`,
+    style: {
+      fg,
+      bg,
+      border: { fg: borderFg },
+    },
+  });
+  screen.render();
+
+  setTimeout(() => {
+    destroyList(modal, screen);
+  }, durationMs);
+}

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

@@ -0,0 +1,185 @@
+/**
+ * AgentVibes TUI — Shared Widget: Personality Picker
+ *
+ * Inline modal list for selecting voice personalities with TTS preview.
+ * Extracted from settings-tab.js for reuse across tabs.
+ */
+
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { destroyList } from './destroy-list.js';
+import { buildAudioEnv } from '../audio-env.js';
+import { BRAND_PINK } from '../brand-colors.js';
+import { PERSONALITY_EMOJIS, PERSONALITIES } from '../constants/personalities.js';
+
+export { PERSONALITY_EMOJIS, PERSONALITIES };
+
+const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
+let blessed;
+if (!IS_TEST) {
+  const { default: b } = await import('blessed');
+  blessed = b;
+}
+
+const _modalTitle = (text) => ` {${BRAND_PINK}-fg}${text}{/${BRAND_PINK}-fg} `;
+
+const PERSONALITY_PREVIEW_PHRASES = Object.freeze({
+  angry:        "UNACCEPTABLE! This build time is a DISASTER! Fix it NOW or so help me!",
+  annoying:     "Oh oh oh! Can I tell you something? Can I? Can I? PLEASE? It is so important!",
+  crass:        "Well damn, that code runs like my uncle's truck. Barely, and it smells funny.",
+  dramatic:     "The tests... have failed. I don't know how much longer I can do this.",
+  'dry-humor':  "Your code worked. I too am surprised.",
+  flirty:       "Ooh, a clean merge? You know exactly how to make my heart race.",
+  funny:        "Why do programmers hate nature? Too many bugs. I will show myself out.",
+  grandpa:      "Back in my day, we compiled by hand. Uphill. In the snow. Both ways.",
+  millennial:   "I literally cannot even with this error. I am so done. Like, actually deceased.",
+  moody:        "...It works. Whatever. Do not get used to it.",
+  pirate:       "Arrr! The build be sailin' smooth today, matey! No barnacles in sight!",
+  poetic:       "Like rivers to the sea, your code flows toward eventual compilation.",
+  professional: "I have completed the requested task and am prepared to document outcomes.",
+  rapper:       "Yo! Clean code flowin', tests are glowin', no bugs showin'!",
+  robot:        "TASK COMPLETE. EFFICIENCY: OPTIMAL. PROBABILITY OF SUCCESS: 97.3 PERCENT. BEEP.",
+  sarcastic:    "Oh wow, another bug. What a completely unexpected surprise. Truly shocking.",
+  sassy:        "Honey, whoever told you that was good code was not your friend.",
+  'surfer-dude':"Duuude! That commit totally shredded! Gnarly clean code, bro!",
+  zen:          "The bug is not the enemy. The bug is the teacher. Breathe. Commit.",
+  random:       "Who will I be today? Even I do not know. Expect the unexpected.",
+});
+
+/**
+ * Open the personality picker modal.
+ *
+ * @param {object}   screen             - blessed screen
+ * @param {string}   currentPersonality - current personality value
+ * @param {Function} onSelect           - called with selected personality
+ * @param {Function} [onClose]          - called after modal closes
+ */
+export function openPersonalityPicker(screen, currentPersonality, onSelect, onClose) {
+  const current = currentPersonality ?? 'none';
+  const currentIdx = Math.max(0, PERSONALITIES.indexOf(current));
+
+  const COLORS = {
+    btnFocus: '#2e7d32',
+    btnFocusFg: '#ffffff',
+  };
+
+  const list = blessed.list({
+    parent: screen,
+    top: 'center',
+    left: 'center',
+    width: 44,
+    height: Math.min(PERSONALITIES.length + 4, 22),
+    border: { type: 'line' },
+    tags: true,
+    label: _modalTitle('Select Personality'),
+    items: PERSONALITIES.map((p, i) => {
+      const emoji = PERSONALITY_EMOJIS[p] ?? '✨';
+      const label = p === 'none' ? 'None' : p.charAt(0).toUpperCase() + p.slice(1);
+      const mark  = i === currentIdx ? '✅' : '   ';
+      return `${mark} ${emoji} ${label}`;
+    }),
+    keys: true,
+    vi: true,
+    mouse: true,
+    style: {
+      border: { fg: COLORS.btnFocus },
+      selected: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
+      item: { fg: '#e3f2fd' },
+    },
+  });
+
+  list.select(currentIdx);
+  list.focus();
+  screen.render();
+
+  // TTS preview on hover
+  let _pickerTtsProc = null;
+  let _playingItemIdx = -1;
+
+  function _setItemPlaying(idx, playing) {
+    const item = list.items?.[idx];
+    if (!item) return;
+    const base = (item.content ?? '').replace(/ █$/, '').replace(/ \(playing\)$/, '');
+    item.setContent(playing ? `${base} (playing)` : base);
+  }
+
+  function _killPickerTts() {
+    if (_pickerTtsProc) {
+      try { process.kill(-_pickerTtsProc.pid, 'SIGTERM'); } catch {}
+      _pickerTtsProc = null;
+    }
+    if (_playingItemIdx >= 0) {
+      _setItemPlaying(_playingItemIdx, false);
+      _playingItemIdx = -1;
+    }
+  }
+
+  function _speakPreview(personality) {
+    _killPickerTts();
+    const phrase = PERSONALITY_PREVIEW_PHRASES[personality];
+    if (!phrase) return;
+    const ttsScript = path.join(process.cwd(), '.claude', 'hooks', 'play-tts.sh');
+    _pickerTtsProc = spawn('bash', [ttsScript, phrase], {
+      stdio: 'ignore',
+      detached: true,
+      env: buildAudioEnv(),
+    });
+    _playingItemIdx = list.selected;
+    _setItemPlaying(_playingItemIdx, true);
+    screen.render();
+    _pickerTtsProc.on('exit', () => {
+      if (_playingItemIdx >= 0) {
+        _setItemPlaying(_playingItemIdx, false);
+        _playingItemIdx = -1;
+        screen.render();
+      }
+      _pickerTtsProc = null;
+    });
+    _pickerTtsProc.unref();
+  }
+
+  list.on('select item', () => {
+    _speakPreview(PERSONALITIES[list.selected]);
+  });
+
+  list.key(['space'], () => {
+    if (_pickerTtsProc && _playingItemIdx === list.selected) {
+      _killPickerTts();
+    } else {
+      _speakPreview(PERSONALITIES[list.selected]);
+    }
+  });
+
+  // Type-to-jump
+  const _jumpBlocked = new Set(['j', 'k', 'g', 'h', 'l', 'd', 'u', 'q']);
+  list.on('keypress', (ch, key) => {
+    if (!ch || key.ctrl || key.meta) return;
+    const lower = ch.toLowerCase();
+    if (!/^[a-z]$/.test(lower)) return;
+    if (_jumpBlocked.has(lower)) return;
+    const count = PERSONALITIES.length;
+    const start = list.selected ?? 0;
+    for (let i = 1; i <= count; i++) {
+      const idx = (start + i) % count;
+      if (PERSONALITIES[idx].startsWith(lower)) {
+        list.select(idx);
+        screen.render();
+        break;
+      }
+    }
+  });
+
+  list.key(['enter'], () => {
+    const selected = PERSONALITIES[list.selected];
+    if (!selected) return;
+    _killPickerTts();
+    // Call onSelect before destroying to avoid stale-state re-renders
+    onSelect(selected);
+    destroyList(list, screen, onClose);
+  });
+
+  list.key(['escape', 'q'], () => {
+    _killPickerTts();
+    destroyList(list, screen, onClose);
+  });
+}

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

@@ -0,0 +1,94 @@
+/**
+ * AgentVibes TUI — Shared Widget: Reverb Preset Picker
+ *
+ * Inline modal list for selecting reverb presets.
+ * Extracted from settings-tab.js for reuse across tabs.
+ */
+
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { destroyList } from './destroy-list.js';
+import { BRAND_PINK } from '../brand-colors.js';
+
+const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
+let blessed;
+if (!IS_TEST) {
+  const { default: b } = await import('blessed');
+  blessed = b;
+}
+
+const _modalTitle = (text) => ` {${BRAND_PINK}-fg}${text}{/${BRAND_PINK}-fg} `;
+
+export const REVERB_PRESETS = Object.freeze([
+  { label: 'Off (Dry, no reverb)',        value: 'off' },
+  { label: 'Light (Small room)',           value: 'light' },
+  { label: 'Medium (Conference room)',     value: 'medium' },
+  { label: 'Heavy (Large hall)',           value: 'heavy' },
+  { label: 'Cathedral (Epic space)',       value: 'cathedral' },
+]);
+
+/**
+ * Open the reverb preset picker modal.
+ *
+ * @param {object}   screen        - blessed screen
+ * @param {string}   currentPreset - current reverb preset value
+ * @param {Function} onSelect      - called with selected preset value
+ * @param {Function} [onClose]     - called after modal closes
+ * @param {object}   [opts]        - options
+ * @param {boolean}  [opts.applyToEffectsManager=true] - whether to apply via effects-manager.sh
+ */
+export function openReverbPicker(screen, currentPreset, onSelect, onClose, opts = {}) {
+  const applyToEffectsManager = opts.applyToEffectsManager !== false;
+  const currentIdx = Math.max(0, REVERB_PRESETS.findIndex(p => p.value === currentPreset));
+
+  const COLORS = {
+    btnFocus: '#2e7d32',
+    btnFocusFg: '#ffffff',
+  };
+
+  const list = blessed.list({
+    parent: screen,
+    top: 'center',
+    left: 'center',
+    width: 40,
+    height: REVERB_PRESETS.length + 4,
+    border: { type: 'line' },
+    tags: true,
+    label: _modalTitle('Select Reverb Preset'),
+    items: REVERB_PRESETS.map((p, i) => (i === currentIdx ? `● ${p.label}` : `  ${p.label}`)),
+    keys: true,
+    vi: false,
+    mouse: true,
+    style: {
+      border: { fg: COLORS.btnFocus },
+      selected: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
+      item: { fg: '#e3f2fd' },
+    },
+  });
+
+  list.select(currentIdx);
+  list.focus();
+  screen.render();
+
+  list.key(['enter', 'space'], () => {
+    const selected = REVERB_PRESETS[list.selected];
+    if (!selected) return;
+
+    if (applyToEffectsManager) {
+      const effectsScript = path.join(process.cwd(), '.claude', 'hooks', 'effects-manager.sh');
+      spawnSync('bash', [effectsScript, 'set-reverb', selected.value, 'default'], {
+        stdio: 'ignore',
+        timeout: 5000,
+        env: { ...process.env },
+      });
+    }
+
+    // Call onSelect before destroying to avoid stale-state re-renders
+    onSelect(selected.value);
+    destroyList(list, screen, onClose);
+  });
+
+  list.key(['escape', 'q'], () => {
+    destroyList(list, screen, onClose);
+  });
+}