@settinghead/voxlert 0.3.5 → 0.3.7

package/src/setup-ui.js

@@ -14,12 +14,12 @@ const ANSI = {
 };
 
 const LOGO_LINES = [
-  "██╗   ██╗ ██████╗ ██╗ ██████╗███████╗███████╗ ██████╗ ██████╗  ██████╗ ███████╗",
-  "██║   ██║██╔═══██╗██║██╔════╝██╔════╝██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝",
-  "██║   ██║██║   ██║██║██║     █████╗  █████╗  ██║   ██║██████╔╝██║  ███╗█████╗  ",
-  "╚██╗ ██╔╝██║   ██║██║██║     ██╔══╝  ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝  ",
-  " ╚████╔╝ ╚██████╔╝██║╚██████╗███████╗██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗",
-  "  ╚═══╝   ╚═════╝ ╚═╝ ╚═════╝╚══════╝╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝",
+  "██╗   ██╗ ██████╗ ██╗  ██╗██╗     ███████╗██████╗ ████████╗",
+  "██║   ██║██╔═══██╗╚██╗██╔╝██║     ██╔════╝██╔══██╗╚══██╔══╝",
+  "██║   ██║██║   ██║ ╚███╔╝ ██║     █████╗  ██████╔╝   ██║   ",
+  "╚██╗ ██╔╝██║   ██║ ██╔██╗ ██║     ██╔══╝  ██╔══██╗   ██║   ",
+  " ╚████╔╝ ╚██████╔╝██╔╝ ██╗███████╗███████╗██║  ██║   ██║   ",
+  "  ╚═══╝   ╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝   ╚═╝   ",
 ];
 
 function color(text, code) {
@@ -84,7 +84,7 @@ function animatedLogoLine(text, phase = 0, shimmerIndex = -1) {
   }).join("") + ANSI.reset;
 }
 
-function centerLine(text, width = 92) {
+function centerLine(text, width = 59) {
   const padding = Math.max(0, Math.floor((width - text.length) / 2));
   return `${" ".repeat(padding)}${text}`;
 }
@@ -98,8 +98,8 @@ function formatCurrentConfig(config, installedPlatforms) {
   const providerLabel = config.llm_api_key
     ? `${provider ? provider.name : (config.llm_backend || "openrouter")} (${config.llm_model || provider?.defaultModel || "default"})`
     : "Fallback only";
-  const ttsLabel = config.tts_backend || "chatterbox";
-  const voiceLabel = config.active_pack || "sc2-adjutant";
+  const ttsLabel = config.tts_backend || "qwen";
+  const voiceLabel = config.active_pack || "sc1-kerrigan-infested";
   const platforms = installedPlatforms.filter(Boolean);
   return [
     `${color("Current", ANSI.dim)} ${providerLabel}`,
@@ -111,18 +111,18 @@ function formatCurrentConfig(config, installedPlatforms) {
 
 function renderLogoFrame(config, installedPlatforms, shimmerStep = -1) {
   const current = formatCurrentConfig(config, installedPlatforms).map((line) => `  ${line}`);
-  const rule = color("┈".repeat(92), ANSI.dim);
+  const rule = color("┈".repeat(59), ANSI.dim);
   const glow = color("SYNTHETIC VOICE NOTIFICATIONS FOR AGENT WORKFLOWS", ANSI.cyan);
   const logo = LOGO_LINES.map((line, index) => {
     const shimmerIndex = shimmerStep >= 0 ? shimmerStep - index * 3 : -1;
     const phase = shimmerStep >= 0 ? shimmerStep * 0.015 + index * 0.02 : index * 0.02;
-    return centerLine(animatedLogoLine(line, phase, shimmerIndex), 92);
+    return centerLine(animatedLogoLine(line, phase, shimmerIndex), 59);
   });
   return [
     "",
     rule,
     ...logo,
-    centerLine(glow, 92),
+    centerLine(glow, 59),
     rule,
     "",
     ...current,

package/src/setup.js

@@ -23,8 +23,6 @@ import { registerCursorHooks, unregisterCursorHooks, hasCursorHooks } from "./cu
 import { registerCodexNotify, getCodexConfigPath, unregisterCodexNotify, hasCodexNotify } from "./codex-config.js";
 import { printSetupHeader, printStep, printStatus, printSuccess, printWarning, highlight } from "./setup-ui.js";
 import {
-  QWEN_DOCS_URL,
-  CHATTERBOX_DOCS_URL,
   probeTtsBackend,
   chooseTtsBackend,
   verifyTtsSetup,
@@ -38,64 +36,68 @@ function validateApiKey(providerId, apiKey) {
     const provider = getProvider(providerId);
     if (!provider) return resolve({ ok: false, error: "Unknown provider" });
 
-    let url;
-    let options;
-
-    const base = provider.baseUrl.replace(/\/+$/, "");
-
-    if (provider.format === "anthropic") {
-      // Anthropic: POST to /v1/messages with a tiny request
-      url = new URL(`${base}/v1/messages`);
-      const authHeaders = provider.authHeader(apiKey);
-      const payload = JSON.stringify({
-        model: provider.defaultModel,
-        max_tokens: 1,
-        messages: [{ role: "user", content: "hi" }],
-      });
-      options = {
-        method: "POST",
-        headers: {
-          ...authHeaders,
-          "Content-Type": "application/json",
-          "Content-Length": Buffer.byteLength(payload),
-        },
-        timeout: 8000,
-      };
-      const req = https.request(url, options, (res) => {
-        let data = "";
-        res.on("data", (chunk) => (data += chunk));
-        res.on("end", () => {
-          if (res.statusCode === 401) return resolve({ ok: false, error: "Invalid API key" });
-          if (res.statusCode === 403) return resolve({ ok: false, error: "API key lacks permissions" });
-          resolve({ ok: res.statusCode < 500 });
+    try {
+      let url;
+      let options;
+
+      const base = provider.baseUrl.replace(/\/+$/, "");
+
+      if (provider.format === "anthropic") {
+        // Anthropic: POST to /v1/messages with a tiny request
+        url = new URL(`${base}/v1/messages`);
+        const authHeaders = provider.authHeader(apiKey);
+        const payload = JSON.stringify({
+          model: provider.defaultModel,
+          max_tokens: 1,
+          messages: [{ role: "user", content: "hi" }],
         });
-      });
-      req.on("error", (err) => resolve({ ok: false, error: err.message }));
-      req.on("timeout", () => { req.destroy(); resolve({ ok: false, error: "Timeout" }); });
-      req.write(payload);
-      req.end();
-    } else {
-      // OpenAI-compatible: GET /models
-      url = new URL(`${base}/models`);
-      const authHeaders = provider.authHeader(apiKey);
-      options = {
-        method: "GET",
-        headers: { ...authHeaders },
-        timeout: 8000,
-      };
-      const reqFn = url.protocol === "https:" ? https.request : http.request;
-      const req = reqFn(url, options, (res) => {
-        let data = "";
-        res.on("data", (chunk) => (data += chunk));
-        res.on("end", () => {
-          if (res.statusCode === 401) return resolve({ ok: false, error: "Invalid API key" });
-          if (res.statusCode === 403) return resolve({ ok: false, error: "API key lacks permissions" });
-          resolve({ ok: res.statusCode >= 200 && res.statusCode < 300 });
+        options = {
+          method: "POST",
+          headers: {
+            ...authHeaders,
+            "Content-Type": "application/json",
+            "Content-Length": Buffer.byteLength(payload),
+          },
+          timeout: 8000,
+        };
+        const req = https.request(url, options, (res) => {
+          let data = "";
+          res.on("data", (chunk) => (data += chunk));
+          res.on("end", () => {
+            if (res.statusCode === 401) return resolve({ ok: false, error: "Invalid API key" });
+            if (res.statusCode === 403) return resolve({ ok: false, error: "API key lacks permissions" });
+            resolve({ ok: res.statusCode < 500 });
+          });
+        });
+        req.on("error", (err) => resolve({ ok: false, error: err.message }));
+        req.on("timeout", () => { req.destroy(); resolve({ ok: false, error: "Timeout" }); });
+        req.write(payload);
+        req.end();
+      } else {
+        // OpenAI-compatible: GET /models
+        url = new URL(`${base}/models`);
+        const authHeaders = provider.authHeader(apiKey);
+        options = {
+          method: "GET",
+          headers: { ...authHeaders },
+          timeout: 8000,
+        };
+        const reqFn = url.protocol === "https:" ? https.request : http.request;
+        const req = reqFn(url, options, (res) => {
+          let data = "";
+          res.on("data", (chunk) => (data += chunk));
+          res.on("end", () => {
+            if (res.statusCode === 401) return resolve({ ok: false, error: "Invalid API key" });
+            if (res.statusCode === 403) return resolve({ ok: false, error: "API key lacks permissions" });
+            resolve({ ok: res.statusCode >= 200 && res.statusCode < 300 });
+          });
         });
-      });
-      req.on("error", (err) => resolve({ ok: false, error: err.message }));
-      req.on("timeout", () => { req.destroy(); resolve({ ok: false, error: "Timeout" }); });
-      req.end();
+        req.on("error", (err) => resolve({ ok: false, error: err.message }));
+        req.on("timeout", () => { req.destroy(); resolve({ ok: false, error: "Timeout" }); });
+        req.end();
+      }
+    } catch (err) {
+      resolve({ ok: false, error: err.message });
     }
   });
 }
@@ -177,13 +179,36 @@ function ensurePacks() {
   }
 }
 
-export async function runSetup() {
+export async function runSetup({ nonInteractive = false } = {}) {
   // Ensure config exists
   ensureConfig();
   ensurePacks();
   mkdirSync(CACHE_DIR, { recursive: true });
 
-  const config = loadConfig();
+  const rawConfig = loadConfig();
+
+  // Auto-persist: any property write saves to disk immediately
+  const config = new Proxy(rawConfig, {
+    set(target, prop, value) {
+      target[prop] = value;
+      try { saveConfig(target); } catch { /* ignore */ }
+      return true;
+    },
+  });
+
+  process.on("SIGINT", () => {
+    console.log("");
+    printWarning("Setup interrupted — progress saved. Run 'voxlert setup' to resume.");
+    console.log("");
+    process.exit(130);
+  });
+
+  try {
+
+  if (nonInteractive) {
+    return await runNonInteractiveSetup(config);
+  }
+
   const currentBackend = config.llm_backend || "openrouter";
   const currentProvider = getProvider(currentBackend);
   const currentModel = config.llm_model || currentProvider?.defaultModel || "default";
@@ -225,6 +250,7 @@ export async function runSetup() {
 
   if (chosenProvider !== "skip") {
     config.llm_backend = chosenProvider;
+
     const provider = getProvider(chosenProvider);
 
     // --- Step 2: API Key ---
@@ -238,7 +264,7 @@ export async function runSetup() {
       ? `${existingKey.slice(0, 4)}…${existingKey.slice(-4)}`
       : "";
 
-    apiKey = await input({
+    apiKey = (await input({
       message: "Paste your API key:",
       default: existingKey || undefined,
       transformer: (val) => {
@@ -247,7 +273,7 @@ export async function runSetup() {
         if (val.length <= 8) return "****";
         return val.slice(0, 4) + "…" + val.slice(-4);
       },
-    });
+    })).trim();
 
     if (apiKey) {
       process.stdout.write("  Validating key... ");
@@ -271,26 +297,30 @@ export async function runSetup() {
 
       if (apiKey) {
         config.llm_api_key = apiKey;
-        // Clear legacy field if using the new unified field
         if (chosenProvider === "openrouter") {
           config.openrouter_api_key = apiKey;
         }
+    
       } else {
         config.llm_api_key = null;
         config.openrouter_api_key = null;
+    
       }
     } else {
       config.llm_api_key = null;
       config.openrouter_api_key = null;
+  
     }
 
     // Set default model for chosen provider
     if (!config.llm_model && !config.openrouter_model) {
       config.llm_model = provider.defaultModel;
+  
     }
   } else {
     config.llm_api_key = null;
     config.openrouter_api_key = null;
+
     console.log("");
     printWarning("Using fallback phrases from the voice pack.");
     console.log("");
@@ -323,7 +353,7 @@ export async function runSetup() {
   }));
 
   const toDownload = await checkbox({
-    message: "Which voice packs do you want to install? (downloaded from GitHub)",
+    message: "Which voice packs do you want to install? (space = toggle, enter = confirm)",
     choices: packChoices,
     required: false,
   });
@@ -362,11 +392,12 @@ export async function runSetup() {
     ];
 
     const chosenPack = await select({
-      message: "Choose a voice pack:",
+      message: "Choose default voice:",
       choices: packChoices,
-      default: active || "sc2-adjutant",
+      default: active || "random",
     });
     config.active_pack = chosenPack;
+
   } else {
     printWarning("No voice packs found. Using default.");
     console.log("");
@@ -378,15 +409,13 @@ export async function runSetup() {
 
   printStatus("Recommended", "Qwen TTS for a more natural voice");
   printStatus("Voice test", `Uses the voice you picked in Step 4 (${config.active_pack || "default"})`);
-  printStatus("Qwen TTS setup docs", QWEN_DOCS_URL);
-  printStatus("Chatterbox setup docs", CHATTERBOX_DOCS_URL);
   console.log("");
 
-  process.stdout.write("  Checking Chatterbox (port 8004)... ");
+  process.stdout.write("  Checking Chatterbox... ");
   const chatterboxUp = await probeTtsBackend(config, "chatterbox");
   console.log(chatterboxUp ? "detected!" : "not running");
 
-  process.stdout.write("  Checking Qwen TTS (port 8100)...   ");
+  process.stdout.write("  Checking Qwen TTS... ");
   const qwenUp = await probeTtsBackend(config, "qwen");
   console.log(qwenUp ? "detected!" : "not running");
 
@@ -419,7 +448,7 @@ export async function runSetup() {
   ];
 
   const selectedPlatforms = await checkbox({
-    message: "Which platforms do you want to install hooks for?",
+    message: "Which platforms do you want to install hooks for? (space = toggle, enter = confirm)",
     choices: platformChoices,
     required: false,
   });
@@ -472,10 +501,106 @@ export async function runSetup() {
     printWarning("No platforms selected. Run 'voxlert setup' again to install hooks later.");
   }
 
-  // --- Save config ---
+  // --- Summary ---
+  printSetupSummary(config, "skip", []);
+
+  } catch (err) {
+    // Inquirer throws on Ctrl+C (ExitPromptError); progress already persisted
+    if (err && (err.name === "ExitPromptError" || err.message === "Prompt was canceled")) {
+  
+      console.log("");
+      printWarning("Setup interrupted — progress saved. Run 'voxlert setup' to resume.");
+      console.log("");
+      return;
+    }
+    throw err;
+  }
+}
+
+/**
+ * Non-interactive setup: accept all defaults, skip prompts.
+ * Useful for CI, Docker, and automated testing.
+ */
+async function runNonInteractiveSetup(config) {
+  console.log("Running non-interactive setup (--yes)...\n");
+
+  // Step 1–2: LLM — skip (fallback phrases only)
+  printStep(1, "LLM Provider");
+  printStatus("LLM", "Skipped (fallback phrases only)");
+  config.llm_api_key = null;
+  config.openrouter_api_key = null;
+  console.log("");
+
+  // Step 3: Download default voice packs
+  printStep(3, "Download voice packs");
+  mkdirSync(PACKS_DIR, { recursive: true });
+
+  const existingPackIds = new Set();
+  try {
+    for (const entry of readdirSync(PACKS_DIR, { withFileTypes: true })) {
+      if (entry.isDirectory() && existsSync(join(PACKS_DIR, entry.name, "pack.json"))) {
+        existingPackIds.add(entry.name);
+      }
+    }
+  } catch {
+    // PACKS_DIR may not exist yet
+  }
+
+  const baseUrl = getPackRegistryBaseUrl();
+  for (const packId of DEFAULT_DOWNLOAD_PACK_IDS) {
+    if (existingPackIds.has(packId)) continue;
+    const pack = PACK_REGISTRY.find((p) => p.id === packId);
+    const label = pack ? pack.name : packId;
+    process.stdout.write(`  Downloading ${label}... `);
+    try {
+      await downloadPack(packId, baseUrl);
+      console.log("done.");
+    } catch (err) {
+      console.log(`failed (${err.message}).`);
+    }
+  }
+  console.log("");
+
+  // Step 4: Voice — random
+  printStep(4, "Voice Pack");
+  config.active_pack = "random";
+  printStatus("Voice", "random");
+  console.log("");
+
+  // Step 5: TTS — detect and pick best available, skip verification
+  printStep(5, "TTS Server");
+
+  process.stdout.write("  Checking Chatterbox... ");
+  const chatterboxUp = await probeTtsBackend(config, "chatterbox");
+  console.log(chatterboxUp ? "detected!" : "not running");
+
+  process.stdout.write("  Checking Qwen TTS... ");
+  const qwenUp = await probeTtsBackend(config, "qwen");
+  console.log(qwenUp ? "detected!" : "not running");
+
+  if (qwenUp) {
+    config.tts_backend = "qwen";
+  } else if (chatterboxUp) {
+    config.tts_backend = "chatterbox";
+  } else {
+    config.tts_backend = config.tts_backend || "qwen";
+  }
+  printStatus("TTS", config.tts_backend + (qwenUp || chatterboxUp ? "" : " (not running — text notifications only)"));
+  console.log("");
+
+  // Step 6: Hooks — skip
+  printStep(6, "Hooks");
+  printStatus("Hooks", "Skipped (run 'voxlert setup' to install hooks later)");
+  console.log("");
+
+  // Save config
   saveConfig(config);
 
-  // --- Summary ---
+  // Summary
+  printSetupSummary(config, "skip", []);
+}
+
+function printSetupSummary(config, chosenProvider, selectedPlatforms) {
   console.log("");
   console.log(highlight("=== Setup Complete ==="));
   console.log("");

package/src/tts-test.js

@@ -1,8 +1,7 @@
-import { writeFileSync, unlinkSync, existsSync } from "fs";
+import { writeFileSync, readFileSync, unlinkSync, existsSync } from "fs";
 import { join } from "path";
 import { request as httpsRequest } from "https";
 import { request as httpRequest } from "http";
-import confirm from "@inquirer/confirm";
 import select from "@inquirer/select";
 import { playFile } from "./audio.js";
 import { loadPack } from "./packs.js";
@@ -38,15 +37,17 @@ export function getTtsChoices(currentBackend) {
   return [
     {
       name: currentBackend === "qwen"
-        ? "Qwen TTS (recommended, current, more natural voice, port 8100)"
-        : "Qwen TTS (recommended, more natural voice, port 8100)",
+        ? "Qwen TTS (recommended, current, more natural voice)"
+        : "Qwen TTS (recommended, more natural voice)",
       value: "qwen",
+      description: `Setup docs: ${QWEN_DOCS_URL}`,
     },
     {
       name: currentBackend === "chatterbox"
-        ? "Chatterbox (current, port 8004)"
-        : "Chatterbox (port 8004)",
+        ? "Chatterbox (current)"
+        : "Chatterbox",
       value: "chatterbox",
+      description: `Setup docs: ${CHATTERBOX_DOCS_URL}`,
     },
   ];
 }
@@ -78,11 +79,69 @@ export function probeTtsBackend(config, backend, timeoutMs = 2000) {
   });
 }
 
-function requestTtsAudio(config, backend, pack) {
+function _registerVoiceForTest(config, pack) {
+  return new Promise((resolve) => {
+    const voicePath = pack.voicePath;
+    const refText = pack.ref_text;
+    if (!voicePath || !existsSync(voicePath) || !refText) return resolve(null);
+
+    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 = `----VoxlertBoundary${Date.now()}`;
+    const parts = [];
+    parts.push(Buffer.from(
+      `--${boundary}\r\nContent-Disposition: form-data; name="ref_text"\r\n\r\n${refText}\r\n`,
+    ));
+    parts.push(Buffer.from(
+      `--${boundary}\r\nContent-Disposition: form-data; name="audio"; filename="voice.wav"\r\n` +
+      `Content-Type: audio/wav\r\n\r\n`,
+    ));
+    parts.push(audioData);
+    parts.push(Buffer.from(`\r\n--${boundary}--\r\n`));
+    const body = Buffer.concat(parts);
+
+    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", (c) => chunks.push(c));
+      res.on("end", () => {
+        try {
+          const result = JSON.parse(Buffer.concat(chunks).toString());
+          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();
+  });
+}
+
+async function requestTtsAudio(config, backend, pack) {
+  let voiceId = null;
+  if (backend === "qwen") {
+    voiceId = await _registerVoiceForTest(config, pack);
+  }
+
   return new Promise((resolve) => {
     const endpoint = getTtsEndpoint(config, backend);
     const body = backend === "qwen"
-      ? { text: TTS_TEST_PHRASE, pack_id: pack.id || "_default" }
+      ? { text: TTS_TEST_PHRASE, ...(voiceId ? { voice_id: voiceId } : {}) }
       : {
           text: TTS_TEST_PHRASE,
           voice_mode: "predefined",
@@ -157,26 +216,18 @@ export async function runTtsSample(config, backend) {
 }
 
 export async function chooseTtsBackend(config, { qwenUp, chatterboxUp }) {
-  if (qwenUp && chatterboxUp) {
-    return select({
-      message: "Both TTS servers detected. Which one to use? Qwen TTS is recommended for a more natural voice.",
-      choices: getTtsChoices(config.tts_backend),
-      default: config.tts_backend || "qwen",
-    });
-  }
-
-  if (qwenUp) {
-    printSuccess("Using Qwen TTS.");
-    return "qwen";
-  }
+  const detected = [qwenUp && "Qwen TTS", chatterboxUp && "Chatterbox"].filter(Boolean);
+  const hint = detected.length > 0
+    ? `Detected: ${detected.join(", ")}. `
+    : "";
 
-  if (chatterboxUp) {
-    printSuccess("Using Chatterbox.");
-    return "chatterbox";
+  if (!qwenUp && !chatterboxUp) {
+    printStatus("Note", "Local TTS needs a GPU or Apple Silicon. Setup still works — you'll get text notifications until TTS is running.");
+    console.log("");
   }
 
   return select({
-    message: "Choose the TTS backend you are setting up. Qwen TTS is recommended for a more natural voice.",
+    message: `${hint}Choose the TTS backend. Qwen TTS is recommended for a more natural voice.`,
     choices: getTtsChoices(config.tts_backend),
     default: config.tts_backend || "qwen",
   });
@@ -186,20 +237,31 @@ export async function verifyTtsSetup(config, backend) {
   const label = getTtsLabel(backend);
   const docsUrl = getTtsDocsUrl(backend);
 
+  const retryOrSkip = [
+    { name: "I have set up the TTS server. Try again.", value: "retry" },
+    { name: "Skip setup (you won't hear any voice!)", value: "skip" },
+  ];
+
+  let attempt = 0;
   while (true) {
+    attempt++;
+    if (attempt > 1) {
+      console.log("\n  ── Retry #" + (attempt - 1) + " ──");
+    }
     console.log("");
     process.stdout.write(`  Checking ${label}... `);
     const backendUp = await probeTtsBackend(config, backend);
     console.log(backendUp ? "detected!" : "not running");
 
     if (!backendUp) {
-      printWarning(`${label} is not running yet. Finish that setup and come back here to try again.`);
+      printWarning(`${label} is not running yet.`);
       printStatus(`${label} docs`, docsUrl);
       console.log("");
-      await confirm({
-        message: `Press enter after ${label} is running to test again.`,
-        default: true,
-      });
+      const action = await select({ message: "What would you like to do?", choices: retryOrSkip });
+      if (action === "skip") {
+        printWarning("Skipped TTS verification. Voice notifications won't work until the server is running.");
+        return;
+      }
       continue;
     }
 
@@ -208,36 +270,39 @@ export async function verifyTtsSetup(config, backend) {
     console.log(ok ? "played." : "failed.");
 
     if (!ok) {
-      printWarning(`The ${label} test failed. Keep the docs open, fix the server, and try again.`);
+      printWarning(`The ${label} test failed.`);
       printStatus(`${label} docs`, docsUrl);
       console.log("");
-      await confirm({
-        message: `Press enter to retry the ${label} test.`,
-        default: true,
-      });
+      const action = await select({ message: "What would you like to do?", choices: retryOrSkip });
+      if (action === "skip") {
+        printWarning("Skipped TTS verification. Voice notifications won't work until the server is fixed.");
+        return;
+      }
       continue;
     }
 
     const heardVoice = await select({
       message: `Did you hear the ${label} voice test?`,
       choices: [
-        { name: "Yes", value: true },
-        { name: "No", value: false },
+        { name: "Yes", value: "yes" },
+        { name: "No, try again", value: "retry" },
+        { name: "Skip (you won't hear any voice!)", value: "skip" },
       ],
-      default: true,
     });
 
-    if (heardVoice) {
+    if (heardVoice === "yes") {
       printSuccess(`${label} verified.`);
       return;
     }
 
-    printWarning("No workaround here. Keep troubleshooting and retry until you hear the voice.");
+    if (heardVoice === "skip") {
+      printWarning("Skipped TTS verification. Voice notifications won't work until the server is fixed.");
+      return;
+    }
+
+    printWarning("Still not working? Local TTS requires specific hardware (Apple Silicon or NVIDIA GPU).");
+    printStatus("Setup help", "https://github.com/settinghead/voxlert/discussions/6");
     printStatus(`${label} docs`, docsUrl);
     console.log("");
-    await confirm({
-      message: "Press enter to play the test again.",
-      default: true,
-    });
   }
 }