@settinghead/voxlert 0.3.5 → 0.3.7

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="https://youtu.be/-aiSZnGNyE4">
+  <a href="https://youtu.be/5xFXGijwJuk?utm_source=github&utm_medium=readme&utm_campaign=phase1">
     <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/demo-thumbnail.png" alt="Voxlert Demo" width="100%" />
   </a>
 </p>
@@ -20,10 +20,23 @@ Existing notification chimes (like [peon-ping](https://github.com/PeonPing/peon-
 
 Voxlert makes each session speak in a distinct character voice with its own tone and vocabulary. You hear *"Query efficiency restored to nominal"* from the HEV Suit in one window and *"Pathetic test suite for code validation processed"* from SHODAN in another, and you know immediately what changed. Because phrases are generated by an LLM instead of picked from a tiny fixed set, they stay varied instead of becoming wallpaper.
 
+## Who this is for
+
+Voxlert is for users who:
+
+- Run two or more AI coding agent sessions concurrently (Claude Code, Cursor, Codex, OpenClaw)
+- Get interrupted by notification chimes but can't tell which window needs attention
+- Want ambient audio feedback that doesn't require looking at a screen
+- Are comfortable installing local tooling (Node.js, optionally Python for TTS)
+
+If you run a single agent session and it's always in focus, Voxlert adds personality but not much utility. If you run several at once and context-switch between them, it's meaningfully useful.
+
 ## Quick Start
 
 ### 1. Install prerequisites
 
+**Minimum:** Node.js 18+ and `afplay` (macOS built-in) or [FFmpeg](docs/installing-ffmpeg.md) (Windows/Linux). That's enough to get started; TTS and SoX are optional.
+
 | Aspect | macOS | Windows | Linux |
 |--------|-------|---------|-------|
 | **Node.js 18+** | [nodejs.org](https://nodejs.org) or `brew install node` | [nodejs.org](https://nodejs.org) or `winget install OpenJS.NodeJS` | [nodejs.org](https://nodejs.org) or distro package (for example `sudo apt install nodejs`) |
@@ -44,6 +57,8 @@ You will also want:
 
 The setup wizard auto-detects running TTS backends. If none are running yet, setup still completes, but you will only get text notifications and fallback phrases until you start one and rerun setup.
 
+> **Can't run local TTS?** Both backends require a GPU or Apple Silicon. Voxlert still works without TTS — you'll get text notifications and fallback phrases. Need help? [Post in Setup help & troubleshooting](https://github.com/settinghead/voxlert/discussions/6).
+
 ### 2. Install and run setup
 
 ```bash
@@ -107,13 +122,16 @@ npm run changeset
 
 ## Supported Voices
 
+The `sc1-adjutant` preview below uses the animated in-game portrait GIF from `assets/sc1-adjutant.gif`.
+
 | | Pack ID | Voice | Source | Status |
 |---|---------|-------|--------|--------|
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc1-adjutant.gif" width="48" height="48" /> | `sc1-adjutant` | **SC1 Adjutant** | StarCraft | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc2-adjutant.jpg" width="48" height="48" /> | `sc2-adjutant` | **SC2 Adjutant** | StarCraft II | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/red-alert-eva.png" width="48" height="48" /> | `red-alert-eva` | **EVA** | Command & Conquer: Red Alert | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc1-kerrigan.gif" width="48" height="48" /> | `sc1-kerrigan` | **SC1 Kerrigan** | StarCraft | ✅ Available |
-| <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc2-kerrigan.jpg" width="48" height="48" /> | `sc2-kerrigan` | **SC2 Kerrigan** | StarCraft II | ✅ Available |
+| <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc1-kerrigan-infested.jpg" width="48" height="48" /> | `sc1-kerrigan-infested` | **SC1 Infested Kerrigan** | StarCraft | ✅ Available |
+| <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc2-kerrigan-infested.jpg" width="48" height="48" /> | `sc2-kerrigan-infested` | **SC2 Infested Kerrigan** | StarCraft II | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/sc1-protoss-advisor.jpg" width="48" height="48" /> | `sc1-protoss-advisor` | **Protoss Advisor** | StarCraft | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/ss1-shodan.png" width="48" height="48" /> | `ss1-shodan` | **SHODAN** | System Shock | ✅ Available |
 | <img src="https://raw.githubusercontent.com/settinghead/voxlert/main/assets/hl-hev-suit.png" width="48" height="48" /> | `hl-hev-suit` | **HEV Suit** | Half-Life | ✅ Available |
@@ -236,8 +254,8 @@ Run `voxlert config path` to find `config.json`. You can edit it directly or use
 | `openrouter_api_key` | string \| null | `null` | Legacy alias used when `llm_backend` is `openrouter` and `llm_api_key` is empty |
 | `openrouter_model` | string \| null | `null` | Legacy alias used when `llm_model` is empty and backend is `openrouter` |
 | `chatterbox_url` | string | `"http://localhost:8004"` | Chatterbox TTS server URL |
-| `tts_backend` | string | `"chatterbox"` | TTS backend: `chatterbox` or `qwen` |
-| `active_pack` | string | `"sc2-adjutant"` | Active voice pack ID |
+| `tts_backend` | string | `"qwen"` | TTS backend: `qwen` or `chatterbox` |
+| `active_pack` | string | `"sc1-kerrigan-infested"` | Active voice pack ID |
 | `volume` | number | `1.0` | Playback volume (0.0-1.0) |
 | `categories` | object | — | Per-category enable/disable settings |
 | `logging` | boolean | `true` | Activity log in `~/.voxlert/voxlert.log` |
@@ -348,6 +366,10 @@ See [Creating Voice Packs](docs/creating-voice-packs.md) for building your own c
 
 - **Protoss Advisor** voice pack inspired by [openclaw/protoss-voice](https://playbooks.com/skills/openclaw/skills/protoss-voice)
 
+## Need help?
+
+Having trouble with setup? Post in the [Setup help & troubleshooting Discussion](https://github.com/settinghead/voxlert/discussions/6).
+
 ## License
 
 MIT - see [LICENSE](LICENSE).

package/config.default.json

@@ -13,9 +13,9 @@
     "timeout": 15000
   },
   "chatterbox_url": "http://localhost:8004",
-  "tts_backend": "chatterbox",
+  "tts_backend": "qwen",
   "qwen_tts_url": "http://localhost:8100",
-  "active_pack": "sc2-adjutant",
+  "active_pack": "sc1-kerrigan-infested",
   "volume": 1.0,
   "logging": true,
   "error_log": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@settinghead/voxlert",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "LLM-generated voice notifications for Claude Code, Cursor, OpenAI Codex, and OpenClaw, spoken by game characters like the StarCraft Adjutant, Kerrigan, C&C EVA, SHODAN, and more.",
   "repository": {
     "type": "git",

package/packs/sc1-kerrigan/pack.json

@@ -1,69 +1,68 @@
 {
   "name": "StarCraft 1 Kerrigan",
-  "overlay_colors": [[0.5, 0.1, 0.6], [0.3, 0.0, 0.4]],
+  "overlay_colors": [[0.4, 0.5, 0.7], [0.2, 0.3, 0.5]],
   "voice": "voice.wav",
   "echo": false,
   "llm_temperature": 0.85,
-  "style": "Sharp, commanding, cunning. Lethally efficient. Mix military precision with predatory superiority.",
+  "style": "Sharp, commanding, cunning. A Ghost operative — military precision with dry wit. Confident and no-nonsense.",
   "examples": [
     {
       "content": "Fixed auth bug",
       "format": "status-report",
-      "response": "Auth weakness for user access eliminated."
+      "response": "Auth weakness patched. Won't happen again."
     },
     {
       "content": "Switched TTS endpoint from /v1/audio/speech to /tts",
       "format": "status-report",
-      "response": "Voice relay for swarm communications rerouted."
+      "response": "Comm relay rerouted. Signal's clean now."
     },
     {
       "content": "Added module-level external store using useSyncExternalStore for React re-renders",
       "format": "status-report",
-      "response": "State dominion for render control seized."
+      "response": "State control locked in. Renders fall in line."
     }
   ],
   "fallback_phrases": {
     "session.start": [
-      "The swarm awakens",
-      "I am here",
-      "Ready to evolve",
-      "The hive stirs",
-      "Awaiting your command"
+      "Kerrigan here",
+      "I've got a job to do",
+      "Ready for orders",
+      "Ghost reporting",
+      "Standing by"
     ],
     "task.complete": [
-      "It is done",
-      "The swarm has delivered",
-      "Objective consumed",
-      "Evolution complete",
-      "Another victory claimed",
-      "Mission accomplished commander"
+      "Job's done",
+      "Target neutralized",
+      "Mission complete",
+      "That's a wrap",
+      "Objective secured"
     ],
     "task.acknowledge": [
-      "I hear you",
-      "The swarm obeys",
+      "Copy that",
+      "Understood",
       "Acknowledged",
-      "As you wish",
+      "On it",
       "Consider it done"
     ],
     "input.required": [
-      "Speak your mind",
-      "The swarm awaits your command",
-      "What would you have me do",
-      "Awaiting your directive",
-      "Choose carefully"
+      "What's the play",
+      "Waiting on your call",
+      "Your orders",
+      "Speak up",
+      "I'm listening"
     ],
     "resource.limit": [
-      "We require more resources",
-      "The swarm hungers",
-      "Our forces are stretched thin",
-      "Reserves nearly depleted",
-      "We need more time"
+      "We're running low",
+      "Resources are tight",
+      "Need more to work with",
+      "Supplies are thin",
+      "We're stretched"
     ],
     "notification": [
-      "Something stirs",
-      "I sense a disturbance",
-      "Alert commander"
+      "Heads up",
+      "Something's coming",
+      "Eyes open"
     ]
   },
-  "ref_text": "You may have time to play games, but I've got a job to do. Ahh! Yes, Cerebrate? What is it now? I'm listening."
+  "ref_text": "You may have time to play games, but I've got a job to do."
 }

package/packs/sc1-kerrigan-infested/pack.json

@@ -0,0 +1,69 @@
+{
+  "name": "StarCraft 1 Infested Kerrigan",
+  "overlay_colors": [[0.5, 0.1, 0.6], [0.3, 0.0, 0.4]],
+  "voice": "voice.wav",
+  "echo": true,
+  "llm_temperature": 0.9,
+  "style": "Dark, predatory, commanding. Speaks as the Queen of Blades — cold superiority laced with alien menace. Mix swarm metaphors with lethal authority.",
+  "examples": [
+    {
+      "content": "Fixed auth bug",
+      "format": "status-report",
+      "response": "Auth weakness consumed by the swarm."
+    },
+    {
+      "content": "Switched TTS endpoint from /v1/audio/speech to /tts",
+      "format": "status-report",
+      "response": "Voice relay rerouted through the hivemind."
+    },
+    {
+      "content": "Added module-level external store using useSyncExternalStore for React re-renders",
+      "format": "status-report",
+      "response": "State control assimilated into the swarm."
+    }
+  ],
+  "fallback_phrases": {
+    "session.start": [
+      "The swarm is eternal",
+      "I have returned",
+      "All shall serve the swarm",
+      "The hivemind awakens",
+      "Evolution begins anew"
+    ],
+    "task.complete": [
+      "It is finished",
+      "The swarm delivers",
+      "All has been consumed",
+      "Evolution is complete",
+      "The cycle ends",
+      "My will made manifest"
+    ],
+    "task.acknowledge": [
+      "The hivemind hears all",
+      "Your will aligns with mine",
+      "So be it",
+      "The swarm answers",
+      "I have foreseen this"
+    ],
+    "input.required": [
+      "Speak mortal",
+      "The swarm awaits",
+      "Choose your path carefully",
+      "Your decision is required",
+      "Even queens must listen"
+    ],
+    "resource.limit": [
+      "The swarm hungers for more",
+      "Our essence grows thin",
+      "More must be consumed",
+      "Resources are finite even for gods",
+      "The hive requires sustenance"
+    ],
+    "notification": [
+      "I sense it",
+      "The hivemind stirs",
+      "Something approaches"
+    ]
+  },
+  "ref_text": "Yes, Cerebrate? What is it now? I'm listening."
+}

package/packs/{sc2-kerrigan → sc2-kerrigan-infested}/pack.json

@@ -1,5 +1,5 @@
 {
-  "name": "StarCraft 2 Kerrigan",
+  "name": "StarCraft 2 Infested Kerrigan",
   "overlay_colors": [[0.5, 0.1, 0.6], [0.3, 0.0, 0.4]],
   "voice": "voice.wav",
   "echo": true,

package/src/audio.js

@@ -9,7 +9,7 @@ import {
   statSync,
   utimesSync,
 } from "fs";
-import { join } from "path";
+import { join, dirname, extname } from "path";
 import { createHash } from "crypto";
 import { spawn, execSync } from "child_process";
 import { request as httpsRequest } from "https";
@@ -18,6 +18,94 @@ import { CACHE_DIR, QUEUE_DIR, LOCK_FILE } from "./paths.js";
 
 const DEFAULT_MAX_CACHE = 150;
 
+// voice_id cache: voicePath -> voice_id (avoids re-uploading every call)
+const _voiceIdCache = new Map();
+
+function _buildMultipart(fields, files) {
+  const boundary = `----VoxlertBoundary${Date.now()}${Math.random().toString(36).slice(2)}`;
+  const parts = [];
+  for (const [name, value] of Object.entries(fields)) {
+    parts.push(Buffer.from(
+      `--${boundary}\r\nContent-Disposition: form-data; name="${name}"\r\n\r\n${value}\r\n`,
+    ));
+  }
+  for (const { name, filename, contentType, data } of files) {
+    parts.push(Buffer.from(
+      `--${boundary}\r\nContent-Disposition: form-data; name="${name}"; filename="${filename}"\r\n` +
+      `Content-Type: ${contentType}\r\n\r\n`,
+    ));
+    parts.push(data);
+    parts.push(Buffer.from("\r\n"));
+  }
+  parts.push(Buffer.from(`--${boundary}--\r\n`));
+  return { boundary, body: Buffer.concat(parts) };
+}
+
+function registerVoiceWithQwen(config, voicePath, refText) {
+  if (_voiceIdCache.has(voicePath)) {
+    return Promise.resolve(_voiceIdCache.get(voicePath));
+  }
+  if (!voicePath || !existsSync(voicePath) || !refText) {
+    return Promise.resolve(null);
+  }
+  return new Promise((resolve) => {
+    const qwenUrl = config.qwen_tts_url || "http://localhost:8100";
+    const endpoint = `${qwenUrl}/voices`;
+
+    let audioData;
+    try {
+      audioData = readFileSync(voicePath);
+    } catch {
+      return resolve(null);
+    }
+
+    const { boundary, body } = _buildMultipart(
+      { ref_text: refText },
+      [{ name: "audio", filename: "voice.wav", contentType: "audio/wav", data: audioData }],
+    );
+
+    const url = new URL(endpoint);
+    const requestFn = url.protocol === "https:" ? httpsRequest : httpRequest;
+
+    const req = requestFn(
+      endpoint,
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": `multipart/form-data; boundary=${boundary}`,
+          "Content-Length": body.length,
+        },
+        timeout: 15000,
+      },
+      (res) => {
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+          res.resume();
+          return resolve(null);
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => {
+          try {
+            const result = JSON.parse(Buffer.concat(chunks).toString());
+            if (result.voice_id) {
+              _voiceIdCache.set(voicePath, result.voice_id);
+            }
+            resolve(result.voice_id || null);
+          } catch {
+            resolve(null);
+          }
+        });
+        res.on("error", () => resolve(null));
+      },
+    );
+
+    req.on("error", () => resolve(null));
+    req.on("timeout", () => { req.destroy(); resolve(null); });
+    req.write(body);
+    req.end();
+  });
+}
+
 function evictCache(cacheDir, maxEntries) {
   let files;
   try {
@@ -250,12 +338,14 @@ function downloadChatterbox(phrase, cachePath, config, voicePath, ttsParams) {
   });
 }
 
-function downloadQwen(phrase, cachePath, config, packId) {
+function downloadQwen(phrase, cachePath, config, voiceId) {
   return new Promise((resolve) => {
     const qwenUrl = config.qwen_tts_url || "http://localhost:8100";
     const endpoint = `${qwenUrl}/tts`;
 
-    const payload = JSON.stringify({ text: phrase, pack_id: packId });
+    const body = { text: phrase };
+    if (voiceId) body.voice_id = voiceId;
+    const payload = JSON.stringify(body);
 
     const url = new URL(endpoint);
     const requestFn = url.protocol === "https:" ? httpsRequest : httpRequest;
@@ -299,9 +389,10 @@ function downloadQwen(phrase, cachePath, config, packId) {
   });
 }
 
-function downloadToCache(phrase, cachePath, config, voicePath, ttsParams, packId) {
+async function downloadToCache(phrase, cachePath, config, voicePath, ttsParams, packId, refText) {
   if (config.tts_backend === "qwen") {
-    return downloadQwen(phrase, cachePath, config, packId);
+    const voiceId = await registerVoiceWithQwen(config, voicePath, refText);
+    return downloadQwen(phrase, cachePath, config, voiceId);
   }
   return downloadChatterbox(phrase, cachePath, config, voicePath, ttsParams);
 }
@@ -329,8 +420,12 @@ function normalizeVolume(cachePath) {
 function postProcess(cachePath, command) {
   if (!command || !existsSync(cachePath)) return;
   const tmpOut = cachePath + ".tmp.wav";
-  // Replace $INPUT and $OUTPUT placeholders in command
-  const cmd = command.replace(/\$INPUT/g, cachePath).replace(/\$OUTPUT/g, tmpOut);
+  // Support both $INPUT and ${INPUT} placeholder styles.
+  const cmd = command
+    .replace(/\$\{INPUT\}/g, cachePath)
+    .replace(/\$INPUT/g, cachePath)
+    .replace(/\$\{OUTPUT\}/g, tmpOut)
+    .replace(/\$OUTPUT/g, tmpOut);
   try {
     execSync(cmd, { timeout: 15000, stdio: "ignore" });
     if (existsSync(tmpOut)) {
@@ -343,6 +438,66 @@ function postProcess(cachePath, command) {
   }
 }
 
+function convertAudioFile(inputPath, outputPath) {
+  const ext = extname(outputPath).toLowerCase();
+  try {
+    if (ext === ".mp3") {
+      execSync(
+        `ffmpeg -y -i "${inputPath}" -ar 44100 -ac 1 -c:a libmp3lame -b:a 96k "${outputPath}"`,
+        { timeout: 15000, stdio: "ignore" },
+      );
+      return true;
+    }
+
+    execSync(
+      `ffmpeg -y -i "${inputPath}" -ar 44100 -ac 1 -c:a pcm_s16le "${outputPath}"`,
+      { timeout: 15000, stdio: "ignore" },
+    );
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function renderPhraseToFile(phrase, outputPath, config, pack) {
+  const outDir = dirname(outputPath);
+  mkdirSync(outDir, { recursive: true });
+
+  const tempBase = join(outDir, `.tmp-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
+  const rawPath = `${tempBase}.raw.wav`;
+  const workingPath = `${tempBase}.wav`;
+  const packId = (pack && pack.id) || "_default";
+  const voicePath = (pack && pack.voicePath) || config.voice || "default.wav";
+  const ttsParams = pack ? pack.tts_params : null;
+  const refText = (pack && pack.ref_text) || null;
+  const customAudioFilter = (pack && pack.audio_filter) || null;
+  const postProcessCmd = (pack && pack.post_process) || null;
+  const echo = pack ? pack.echo !== false : true;
+
+  try {
+    await downloadToCache(phrase, rawPath, config, voicePath, ttsParams, packId, refText);
+    if (!existsSync(rawPath)) return false;
+
+    renameSync(rawPath, workingPath);
+
+    if (postProcessCmd) postProcess(workingPath, postProcessCmd);
+    if (customAudioFilter || echo) applyEcho(workingPath, customAudioFilter);
+    normalizeVolume(workingPath);
+
+    return convertAudioFile(workingPath, outputPath);
+  } finally {
+    for (const path of [rawPath, workingPath]) {
+      if (existsSync(path)) {
+        try {
+          unlinkSync(path);
+        } catch {
+          // ignore cleanup failures
+        }
+      }
+    }
+  }
+}
+
 // --- Public API ---
 
 export async function speakPhrase(phrase, config, pack) {
@@ -351,7 +506,7 @@ export async function speakPhrase(phrase, config, pack) {
   mkdirSync(packCacheDir, { recursive: true });
 
   const ttsParams = pack ? pack.tts_params : null;
-  const backend = config.tts_backend || "chatterbox";
+  const backend = config.tts_backend || "qwen";
   const cacheKey = createHash("md5")
     .update(backend + ":" + phrase.toLowerCase() + (ttsParams ? JSON.stringify(ttsParams) : ""))
     .digest("hex");
@@ -360,6 +515,7 @@ export async function speakPhrase(phrase, config, pack) {
   const maxCache = config.max_cache_entries ?? DEFAULT_MAX_CACHE;
   const echo = pack ? pack.echo !== false : true;
   const voicePath = (pack && pack.voicePath) || config.voice || "default.wav";
+  const refText = (pack && pack.ref_text) || null;
   const customAudioFilter = (pack && pack.audio_filter) || null;
   const postProcessCmd = (pack && pack.post_process) || null;
 
@@ -367,8 +523,8 @@ export async function speakPhrase(phrase, config, pack) {
   if (existsSync(cachePath)) {
     touchFile(cachePath);
   } else {
-    await downloadToCache(phrase, cachePath, config, voicePath, ttsParams, packId);
-    if (!existsSync(cachePath)) return; // download failed
+    await downloadToCache(phrase, cachePath, config, voicePath, ttsParams, packId, refText);
+    if (!existsSync(cachePath)) return false; // download failed
     if (postProcessCmd) postProcess(cachePath, postProcessCmd);
     if (customAudioFilter || echo) applyEcho(cachePath, customAudioFilter);
     normalizeVolume(cachePath);

package/src/cli.js

@@ -23,7 +23,29 @@ function createHelpText() {
 
 async function maybeRunSetup(command) {
   if (command.skipSetupWizard || existsSync(STATE_DIR)) return false;
-  console.log("Welcome to Voxlert! Let's get you set up.\n");
+  const args = process.argv.slice(2);
+  const nonInteractive = args.includes("--yes") || args.includes("-y");
+  if (nonInteractive) {
+    const { runSetup } = await import("./setup.js");
+    await runSetup({ nonInteractive: true });
+    return true;
+  }
+  console.log("Welcome to Voxlert! First time here?\n");
+  const select = (await import("@inquirer/select")).default;
+  const action = await select({
+    message: "What would you like to do?",
+    choices: [
+      { name: "Run setup", value: "setup", description: "Configure LLM, voice packs, TTS, and hooks" },
+      { name: "Show command list", value: "help", description: "See all available commands" },
+    ],
+    default: "setup",
+  });
+  if (action === "help") {
+    console.log("");
+    console.log(createHelpText());
+    return true;
+  }
+  console.log("");
   const { runSetup } = await import("./setup.js");
   await runSetup();
   return true;

package/src/commands/pack-helpers.js

@@ -37,13 +37,21 @@ export async function testPipeline(text, pack) {
   showOverlay(phrase, {
     category: "notification",
     packName: activePack.name,
-    packId: activePack.id || (config.active_pack || "sc2-adjutant"),
+    packId: activePack.id || (config.active_pack || "sc1-kerrigan-infested"),
     prefix: "Test",
     config,
     overlayColors: activePack.overlay_colors,
   });
-  await speakPhrase(phrase, config, activePack);
-  console.log("Done.");
+  const ok = await speakPhrase(phrase, config, activePack);
+  if (ok === false) {
+    console.log("");
+    console.log("TTS failed — no audio was produced.");
+    console.log("Make sure your TTS server is running (see: voxlert setup).");
+    console.log("");
+    console.log("Need help? https://github.com/settinghead/voxlert/discussions/6");
+  } else {
+    console.log("Done.");
+  }
 }
 
 export function packList() {

package/src/commands/setup.js

@@ -3,11 +3,13 @@ export const setupCommand = {
   aliases: [],
   help: [
     "  voxlert setup               Interactive setup wizard (LLM, voice, TTS, hooks)",
+    "  voxlert setup --yes         Accept all defaults non-interactively",
   ],
   skipSetupWizard: true,
   skipUpgradeCheck: false,
-  async run() {
+  async run({ args }) {
+    const nonInteractive = args.includes("--yes") || args.includes("-y");
     const { runSetup } = await import("../setup.js");
-    await runSetup();
+    await runSetup({ nonInteractive });
   },
 };

package/src/cost.js

@@ -99,7 +99,10 @@ export async function formatCost() {
     totalTokens += e.total_tokens || 0;
   }
 
-  const lines = ["Usage Summary", "=".repeat(40)];
+  const earliest = entries.reduce((min, e) => e.timestamp && e.timestamp < min ? e.timestamp : min, entries[0].timestamp || "");
+  const sinceLabel = earliest ? `Since ${new Date(earliest).toLocaleDateString(undefined, { year: "numeric", month: "short", day: "numeric" })}` : "";
+
+  const lines = ["Usage Summary" + (sinceLabel ? ` (${sinceLabel})` : ""), "=".repeat(40)];
 
   let grandCost = 0;
   let totalEstimated = 0;

package/src/pack-registry.js

@@ -13,7 +13,8 @@ export const PACK_REGISTRY = [
   { id: "sc1-adjutant", name: "StarCraft 1 Adjutant" },
   { id: "red-alert-eva", name: "Red Alert EVA" },
   { id: "sc1-kerrigan", name: "SC1 Kerrigan" },
-  { id: "sc2-kerrigan", name: "SC2 Kerrigan" },
+  { id: "sc1-kerrigan-infested", name: "SC1 Infested Kerrigan" },
+  { id: "sc2-kerrigan-infested", name: "SC2 Infested Kerrigan" },
   { id: "sc1-protoss-advisor", name: "Protoss Advisor (SC1)" },
   { id: "sc2-protoss-advisor", name: "Protoss Advisor (SC2)" },
   { id: "ss1-shodan", name: "SHODAN" },

package/src/packs.js

@@ -146,6 +146,7 @@ export function loadPack(config) {
     voicePath,
     volumeOffsetDb: getVolumeOffsetDb(voicePath, packId),
     tts_params: packData.tts_params || null,
+    ref_text: packData.ref_text || null,
     audio_filter: packData.audio_filter || null,
     post_process: packData.post_process || null,
     style: packData.style || packData.system_prompt || null,