@hirra/vibemeter 0.1.2 → 0.1.4

package/bin/vibemeter-notify.sh

@@ -0,0 +1,172 @@
+#!/usr/bin/env bash
+# vibemeter-notify — speak + display a macOS notification when Claude Code /
+# Codex finishes. Driven by env vars so Vibemeter's settings page can rewrite
+# the hook command without redeploying this script.
+#
+# Usage: vibemeter-notify <tool> <status>
+#   tool   — "Claude", "Codex", ... (shown in the title + spoken)
+#   status — complete | needs_input | failed | <anything else>
+
+set -euo pipefail
+
+TOOL="${1:-AI}"
+STATUS="${2:-complete}"
+LOCALE="${VIBEMETER_NOTIFY_LOCALE:-zh}"
+PROJECT="${VIBEMETER_NOTIFY_PROJECT:-$(basename "${PWD:-unknown}")}"
+LOCK_DIR="${VIBEMETER_NOTIFY_LOCK_DIR:-${TMPDIR:-/tmp}/vibemeter-notify.lock}"
+STATE_FILE="${VIBEMETER_NOTIFY_STATE_FILE:-${TMPDIR:-/tmp}/vibemeter-notify.last}"
+DEDUPE_SECONDS="${VIBEMETER_NOTIFY_DEDUPE_SECONDS:-4}"
+
+# Voice default depends on locale: Chinese voice for zh, system default for en
+# (English say without -v uses the user's system voice, usually Alex / Samantha).
+if [[ -n "${VIBEMETER_NOTIFY_VOICE:-}" ]]; then
+  VOICE="$VIBEMETER_NOTIFY_VOICE"
+elif [[ "$LOCALE" == "en" ]]; then
+  VOICE=""  # empty means: let `say` pick the system default
+else
+  VOICE="Tingting"
+fi
+
+if [[ "$LOCALE" == "en" ]]; then
+  case "$STATUS" in
+    complete|done|success)
+      TITLE="$TOOL done"
+      BODY="$PROJECT finished"
+      SAY_SUFFIX="done"
+      ;;
+    needs_input|input|intervention|permission)
+      TITLE="$TOOL needs you"
+      BODY="$PROJECT needs your attention"
+      SAY_SUFFIX="needs you"
+      ;;
+    failed|fail|error)
+      TITLE="$TOOL may have failed"
+      BODY="$PROJECT may have failed"
+      SAY_SUFFIX="may have failed"
+      ;;
+    *)
+      TITLE="$TOOL notice"
+      BODY="$PROJECT $STATUS"
+      SAY_SUFFIX="$STATUS"
+      ;;
+  esac
+  SAY_TEXT="$TOOL [[slnc 80]]$PROJECT[[slnc 80]] $SAY_SUFFIX"
+else
+  case "$STATUS" in
+    complete|done|success)
+      TITLE="$TOOL 完成"
+      BODY="$PROJECT 已完成"
+      SAY_SUFFIX="完成"
+      ;;
+    needs_input|input|intervention|permission)
+      TITLE="$TOOL 需要介入"
+      BODY="$PROJECT 需要你看一下"
+      SAY_SUFFIX="需要你看一下"
+      ;;
+    failed|fail|error)
+      TITLE="$TOOL 可能失败"
+      BODY="$PROJECT 可能失败了"
+      SAY_SUFFIX="可能失败"
+      ;;
+    *)
+      TITLE="$TOOL 通知"
+      BODY="$PROJECT $STATUS"
+      SAY_SUFFIX="$STATUS"
+      ;;
+  esac
+  SAY_TEXT="$TOOL [[slnc 80]]$PROJECT[[slnc 80]] $SAY_SUFFIX"
+fi
+KEY="$TOOL|$PROJECT|$STATUS"
+LOCK_HELD=0
+
+release_lock() {
+  if [[ "$LOCK_HELD" == "1" ]]; then
+    rmdir "$LOCK_DIR" 2>/dev/null || true
+  fi
+}
+
+acquire_lock() {
+  local i
+  for i in {1..150}; do
+    if mkdir "$LOCK_DIR" 2>/dev/null; then
+      LOCK_HELD=1
+      trap release_lock EXIT
+      return 0
+    fi
+    sleep 0.1
+  done
+  return 1
+}
+
+escape_osascript_string() {
+  printf '%s' "$1" | sed 's/\\/\\\\/g; s/"/\\"/g'
+}
+
+should_skip_duplicate() {
+  local now last_ts last_key
+  now="$(date +%s)"
+  if [[ -f "$STATE_FILE" ]]; then
+    IFS=$'\t' read -r last_ts last_key < "$STATE_FILE" || true
+    if [[ "${last_key:-}" == "$KEY" && "${last_ts:-0}" =~ ^[0-9]+$ ]]; then
+      if (( now - last_ts < DEDUPE_SECONDS )); then
+        return 0
+      fi
+    fi
+  fi
+  mkdir -p "$(dirname "$STATE_FILE")" 2>/dev/null || true
+  printf '%s\t%s\n' "$now" "$KEY" > "$STATE_FILE"
+  return 1
+}
+
+emit_dry_run() {
+  printf 'TITLE=%s\n' "$TITLE"
+  printf 'SUBTITLE=%s\n' "$PROJECT"
+  printf 'BODY=%s\n' "$BODY"
+  printf 'SAY=%s\n' "$SAY_TEXT"
+}
+
+main() {
+  acquire_lock || true
+
+  if should_skip_duplicate; then
+    if [[ "${VIBEMETER_NOTIFY_DRY_RUN:-0}" == "1" ]]; then
+      printf 'SKIPPED=duplicate\n'
+    fi
+    return 0
+  fi
+
+  if [[ "${VIBEMETER_NOTIFY_DRY_RUN:-0}" == "1" ]]; then
+    emit_dry_run
+    return 0
+  fi
+
+  local title subtitle body
+  title="$(escape_osascript_string "$TITLE")"
+  subtitle="$(escape_osascript_string "$PROJECT")"
+  body="$(escape_osascript_string "$BODY")"
+
+  if [[ "${VIBEMETER_NOTIFY_VISUAL:-1}" != "0" ]]; then
+    # Prefer the bundled Vibemeter binary so the banner is attributed to
+    # Vibemeter and can carry an app icon. Fall back to osascript when the
+    # bundle hasn't been built yet (e.g. user never ran `vibemeter float`).
+    local data_dir="${VIBEMETER_DATA_DIR:-$HOME/.vibemeter}"
+    local app_bin="$data_dir/Vibemeter.app/Contents/MacOS/Vibemeter"
+    if [[ -x "$app_bin" ]]; then
+      "$app_bin" --notify "$TITLE" "$BODY" "$TOOL" >/dev/null 2>&1 \
+        || osascript -e "display notification \"$body\" with title \"$title\" subtitle \"$subtitle\"" >/dev/null 2>&1 \
+        || true
+    else
+      osascript -e "display notification \"$body\" with title \"$title\" subtitle \"$subtitle\"" >/dev/null 2>&1 || true
+    fi
+  fi
+
+  if [[ "${VIBEMETER_NOTIFY_SOUND:-1}" != "0" ]]; then
+    if [[ -n "$VOICE" ]]; then
+      say -v "$VOICE" "$SAY_TEXT" >/dev/null 2>&1 || say "$SAY_TEXT" >/dev/null 2>&1 || true
+    else
+      say "$SAY_TEXT" >/dev/null 2>&1 || true
+    fi
+  fi
+}
+
+main "$@"

package/bin/vibemeter.mjs

@@ -4,12 +4,14 @@
  *
  *   vibemeter            start the server in the foreground
  *   vibemeter install    register as a LaunchAgent so it boots on login (macOS)
+ *   vibemeter float      open the desktop floating widget
  *   vibemeter uninstall  remove the LaunchAgent
  *   vibemeter status     show whether the daemon is loaded / running
  */
 
 import { spawn, spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync, writeFileSync, rmSync, readFileSync } from 'node:fs';
+import { existsSync, mkdirSync, writeFileSync, rmSync, readFileSync, statSync, copyFileSync } from 'node:fs';
+import { createInterface } from 'node:readline';
 import { fileURLToPath } from 'node:url';
 import { dirname, join, resolve as resolvePath } from 'node:path';
 import { homedir, platform } from 'node:os';
@@ -18,11 +20,16 @@ import { createRequire } from 'node:module';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const ROOT = join(__dirname, '..');
 const REQUIRE_HOOK = join(__dirname, 'require-hook.cjs');
+const FLOAT_SWIFT = join(__dirname, 'vibemeter-float.swift');
+const NOTIFY_SCRIPT = join(__dirname, 'vibemeter-notify.sh');
 const DEFAULT_PORT = 9527;
 const PORT = process.env.PORT ?? String(DEFAULT_PORT);
 const DATA_DIR = process.env.VIBEMETER_DATA_DIR ?? join(homedir(), '.vibemeter');
 const LABEL = 'com.hirra.vibemeter';
 const PLIST_PATH = join(homedir(), 'Library', 'LaunchAgents', `${LABEL}.plist`);
+const CLAUDE_SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
+const CODEX_CONFIG_PATH = join(homedir(), '.codex', 'config.toml');
+const HOOK_MARKER = 'vibemeter-notify.sh';
 
 process.env.VIBEMETER_DATA_DIR = DATA_DIR;
 mkdirSync(DATA_DIR, { recursive: true });
@@ -169,6 +176,77 @@ function macStatus() {
   }
 }
 
+// Compile the Swift binary into a minimal .app bundle so it has a stable
+// CFBundleIdentifier — UNUserNotificationCenter refuses to deliver banners
+// from unbundled binaries. The bundle also keeps the Dock icon hidden via
+// LSUIElement and gives users a real "Vibemeter" name in the notification.
+const APP_BUNDLE = join(DATA_DIR, 'Vibemeter.app');
+const APP_BINARY = join(APP_BUNDLE, 'Contents', 'MacOS', 'Vibemeter');
+const APP_INFO_PLIST = join(APP_BUNDLE, 'Contents', 'Info.plist');
+
+function infoPlistXml() {
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key><string>Vibemeter</string>
+  <key>CFBundleDisplayName</key><string>Vibemeter</string>
+  <key>CFBundleIdentifier</key><string>com.hirra.vibemeter</string>
+  <key>CFBundleExecutable</key><string>Vibemeter</string>
+  <key>CFBundlePackageType</key><string>APPL</string>
+  <key>CFBundleVersion</key><string>1</string>
+  <key>CFBundleShortVersionString</key><string>1.0</string>
+  <key>LSMinimumSystemVersion</key><string>11.0</string>
+  <key>LSUIElement</key><true/>
+  <key>NSHighResolutionCapable</key><true/>
+</dict>
+</plist>
+`;
+}
+
+function resolveFloatBinary() {
+  if (!existsSync(FLOAT_SWIFT)) return null;
+  const stale = !existsSync(APP_BINARY) || statSync(APP_BINARY).mtimeMs < statSync(FLOAT_SWIFT).mtimeMs;
+  if (!stale && existsSync(APP_INFO_PLIST)) return APP_BINARY;
+
+  mkdirSync(dirname(APP_BINARY), { recursive: true });
+  writeFileSync(APP_INFO_PLIST, infoPlistXml());
+  const result = spawnSync('/usr/bin/swiftc', [FLOAT_SWIFT, '-o', APP_BINARY], {
+    stdio: 'inherit',
+    env: process.env,
+  });
+  return result.status === 0 ? APP_BINARY : null;
+}
+
+function openFloat() {
+  const url = `http://localhost:${PORT}/float`;
+  if (platform() === 'darwin') {
+    const binary = resolveFloatBinary();
+    const native = binary
+      ? spawn(binary, [url], {
+          detached: true,
+          stdio: 'ignore',
+          env: { ...process.env, VIBEMETER_DATA_DIR: DATA_DIR },
+        })
+      : null;
+    if (native) {
+      native.unref();
+      console.log(`✓ Opened Vibemeter floating window (${url})`);
+      return;
+    }
+
+    const app = spawnSync('open', ['-na', 'Google Chrome', '--args', `--app=${url}`, '--window-size=260,380'], { stdio: 'inherit' });
+    if (app.status === 0) return;
+    spawnSync('open', [url], { stdio: 'inherit' });
+    return;
+  }
+  if (platform() === 'linux') {
+    spawnSync('xdg-open', [url], { stdio: 'inherit' });
+    return;
+  }
+  console.log(url);
+}
+
 function linuxInstallHint() {
   const scriptPath = resolvePath(fileURLToPath(import.meta.url));
   const unitPath = join(homedir(), '.config', 'systemd', 'user', 'vibemeter.service');
@@ -181,16 +259,289 @@ function linuxInstallHint() {
   console.log(`\n(target file: ${unitPath})`);
 }
 
+// ── voice notifications ──────────────────────────────────────────────────
+
+function timestampTag() {
+  const d = new Date();
+  const pad = (n) => String(n).padStart(2, '0');
+  return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
+}
+
+function backupOnce(path, tag) {
+  if (!existsSync(path)) return null;
+  const bak = `${path}.bak-vibemeter-${tag}`;
+  copyFileSync(path, bak);
+  return bak;
+}
+
+function readJsonSafe(path) {
+  try { return JSON.parse(readFileSync(path, 'utf8')); }
+  catch { return null; }
+}
+
+function writeJsonPretty(path, obj) {
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, JSON.stringify(obj, null, 2) + '\n');
+}
+
+function buildHookCommand(locale = 'zh') {
+  // Hook commands inherit a restricted PATH; absolute path is required.
+  // Locale env prefix is baked into the command so the bash speaker picks
+  // the right phrases without needing to read another config file.
+  return `VIBEMETER_NOTIFY_LOCALE=${shellQuote(locale)} ${shellQuote(NOTIFY_SCRIPT)} Claude`;
+}
+
+function shellQuote(s) {
+  if (/^[A-Za-z0-9_\-./]+$/.test(s)) return s;
+  return `'${String(s).replace(/'/g, `'\\''`)}'`;
+}
+
+function ensureClaudeHook(settings, eventName, statusArg, locale) {
+  if (!settings.hooks || typeof settings.hooks !== 'object') settings.hooks = {};
+  const list = Array.isArray(settings.hooks[eventName]) ? settings.hooks[eventName] : [];
+  const command = `${buildHookCommand(locale)} ${statusArg}`;
+  // Replace any existing Vibemeter hook so re-applying with a new locale
+  // updates the env prefix in place.
+  const filtered = list
+    .map((entry) => {
+      if (!Array.isArray(entry?.hooks)) return entry;
+      const kept = entry.hooks.filter((h) => !(typeof h?.command === 'string' && h.command.includes(HOOK_MARKER)));
+      return kept.length ? { ...entry, hooks: kept } : null;
+    })
+    .filter(Boolean);
+  filtered.push({ hooks: [{ type: 'command', command, async: true }] });
+  settings.hooks[eventName] = filtered;
+  return true;
+}
+
+function stripClaudeHook(settings, eventName) {
+  if (!settings.hooks || !Array.isArray(settings.hooks[eventName])) return false;
+  const before = settings.hooks[eventName];
+  const after = before
+    .map((entry) => {
+      if (!Array.isArray(entry?.hooks)) return entry;
+      const kept = entry.hooks.filter((h) => !(typeof h?.command === 'string' && h.command.includes(HOOK_MARKER)));
+      return kept.length ? { ...entry, hooks: kept } : null;
+    })
+    .filter(Boolean);
+  if (after.length === before.length && after.every((e, i) => e === before[i])) return false;
+  if (after.length === 0) delete settings.hooks[eventName];
+  else settings.hooks[eventName] = after;
+  return true;
+}
+
+function installClaudeHooks({ stop, notification, locale = 'zh' }) {
+  const settings = readJsonSafe(CLAUDE_SETTINGS_PATH) ?? {};
+  let changed = false;
+  if (stop) changed = ensureClaudeHook(settings, 'Stop', 'complete', locale) || changed;
+  if (notification) changed = ensureClaudeHook(settings, 'Notification', 'needs_input', locale) || changed;
+  if (!changed) return { changed: false, backup: null };
+  const backup = backupOnce(CLAUDE_SETTINGS_PATH, timestampTag());
+  writeJsonPretty(CLAUDE_SETTINGS_PATH, settings);
+  return { changed: true, backup };
+}
+
+function uninstallClaudeHooks() {
+  const settings = readJsonSafe(CLAUDE_SETTINGS_PATH);
+  if (!settings) return { changed: false, backup: null };
+  const removedStop = stripClaudeHook(settings, 'Stop');
+  const removedNotif = stripClaudeHook(settings, 'Notification');
+  if (!removedStop && !removedNotif) return { changed: false, backup: null };
+  if (settings.hooks && Object.keys(settings.hooks).length === 0) delete settings.hooks;
+  const backup = backupOnce(CLAUDE_SETTINGS_PATH, timestampTag());
+  writeJsonPretty(CLAUDE_SETTINGS_PATH, settings);
+  return { changed: true, backup };
+}
+
+function codexNotifyLine(locale = 'zh') {
+  // Codex's notify config is an exec array — locale prefix needs a sh -c wrapper.
+  return `notify = ["sh", "-c", ${JSON.stringify(`VIBEMETER_NOTIFY_LOCALE=${locale} ${NOTIFY_SCRIPT.replace(/'/g, `'\\''`)} Codex complete`)}]`;
+}
+
+function installCodexNotify(locale = 'zh') {
+  if (!existsSync(CODEX_CONFIG_PATH)) {
+    return { changed: false, backup: null, skipped: 'no-config' };
+  }
+  const original = readFileSync(CODEX_CONFIG_PATH, 'utf8');
+  const lines = original.split(/\r?\n/);
+  // Find top-level `notify = ...` (before any [section] header).
+  let notifyIndex = -1;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (/^\s*\[/.test(line)) break;
+    if (/^\s*notify\s*=/.test(line)) { notifyIndex = i; break; }
+  }
+  const want = codexNotifyLine(locale);
+  if (notifyIndex >= 0) {
+    if (lines[notifyIndex].trim() === want) return { changed: false, backup: null };
+    if (!lines[notifyIndex].includes(HOOK_MARKER)) {
+      return { changed: false, backup: null, skipped: 'foreign-notify', existing: lines[notifyIndex] };
+    }
+    lines[notifyIndex] = want;
+  } else {
+    // Insert before the first [section] header, or at the top if none.
+    let insertAt = lines.findIndex((l) => /^\s*\[/.test(l));
+    if (insertAt < 0) insertAt = lines.length;
+    lines.splice(insertAt, 0, want);
+  }
+  const backup = backupOnce(CODEX_CONFIG_PATH, timestampTag());
+  writeFileSync(CODEX_CONFIG_PATH, lines.join('\n'));
+  return { changed: true, backup };
+}
+
+function uninstallCodexNotify() {
+  if (!existsSync(CODEX_CONFIG_PATH)) return { changed: false, backup: null };
+  const original = readFileSync(CODEX_CONFIG_PATH, 'utf8');
+  const lines = original.split(/\r?\n/);
+  let removed = false;
+  for (let i = 0; i < lines.length; i++) {
+    if (/^\s*\[/.test(lines[i])) break;
+    if (/^\s*notify\s*=/.test(lines[i]) && lines[i].includes(HOOK_MARKER)) {
+      lines.splice(i, 1);
+      removed = true;
+      break;
+    }
+  }
+  if (!removed) return { changed: false, backup: null };
+  const backup = backupOnce(CODEX_CONFIG_PATH, timestampTag());
+  writeFileSync(CODEX_CONFIG_PATH, lines.join('\n'));
+  return { changed: true, backup };
+}
+
+function notifyInstall(opts = {}) {
+  const { stop = true, notification = false, codex = true, locale = process.env.VIBEMETER_NOTIFY_LOCALE || 'zh' } = opts;
+  if (!existsSync(NOTIFY_SCRIPT)) {
+    console.error(`Notify script missing: ${NOTIFY_SCRIPT}`);
+    process.exit(1);
+  }
+  // Build the .app bundle eagerly so the very first hook firing can use the
+  // native notification path instead of falling back to osascript.
+  if (platform() === 'darwin') resolveFloatBinary();
+  const cl = installClaudeHooks({ stop, notification, locale });
+  const cx = codex ? installCodexNotify(locale) : { changed: false, backup: null, skipped: 'disabled' };
+  console.log('');
+  console.log('  Vibemeter voice notifications');
+  if (cl.changed) console.log(`  ✓ Claude Code hooks updated (${CLAUDE_SETTINGS_PATH})`);
+  else console.log(`  · Claude Code hooks already in place`);
+  if (cl.backup) console.log(`    backup: ${cl.backup}`);
+  if (cx.changed) console.log(`  ✓ Codex notify updated (${CODEX_CONFIG_PATH})`);
+  else if (cx.skipped === 'no-config') console.log(`  · Codex config not found — skipped`);
+  else if (cx.skipped === 'foreign-notify') console.log(`  ! Codex notify already set to: ${cx.existing} — left as-is`);
+  else if (cx.skipped === 'disabled') console.log(`  · Codex notify left unchanged`);
+  else console.log(`  · Codex notify already pointing to Vibemeter`);
+  if (cx.backup) console.log(`    backup: ${cx.backup}`);
+  console.log('');
+  console.log('  Open http://localhost:' + PORT + '/settings to change voice or disable.');
+}
+
+function notifyUninstall() {
+  const cl = uninstallClaudeHooks();
+  const cx = uninstallCodexNotify();
+  console.log('');
+  if (cl.changed) console.log(`  ✓ Removed Vibemeter hooks from ${CLAUDE_SETTINGS_PATH}`);
+  else console.log(`  · No Vibemeter hooks in ${CLAUDE_SETTINGS_PATH}`);
+  if (cl.backup) console.log(`    backup: ${cl.backup}`);
+  if (cx.changed) console.log(`  ✓ Removed Vibemeter notify from ${CODEX_CONFIG_PATH}`);
+  else console.log(`  · No Vibemeter notify in ${CODEX_CONFIG_PATH}`);
+  if (cx.backup) console.log(`    backup: ${cx.backup}`);
+  console.log('');
+}
+
+function notifyStatusObject() {
+  const settings = readJsonSafe(CLAUDE_SETTINGS_PATH);
+  const hasClaudeHook = (event) => {
+    const list = settings?.hooks?.[event];
+    if (!Array.isArray(list)) return false;
+    return list.some((entry) =>
+      Array.isArray(entry?.hooks) && entry.hooks.some((h) => typeof h?.command === 'string' && h.command.includes(HOOK_MARKER)),
+    );
+  };
+  let codexInstalled = false;
+  let codexForeign = null;
+  if (existsSync(CODEX_CONFIG_PATH)) {
+    const lines = readFileSync(CODEX_CONFIG_PATH, 'utf8').split(/\r?\n/);
+    for (const line of lines) {
+      if (/^\s*\[/.test(line)) break;
+      if (/^\s*notify\s*=/.test(line)) {
+        if (line.includes(HOOK_MARKER)) codexInstalled = true;
+        else codexForeign = line.trim();
+        break;
+      }
+    }
+  }
+  return {
+    scriptPath: NOTIFY_SCRIPT,
+    claudeSettingsPath: CLAUDE_SETTINGS_PATH,
+    codexConfigPath: CODEX_CONFIG_PATH,
+    claudeStop: hasClaudeHook('Stop'),
+    claudeNotification: hasClaudeHook('Notification'),
+    codex: codexInstalled,
+    codexForeign,
+    codexConfigExists: existsSync(CODEX_CONFIG_PATH),
+  };
+}
+
+function notifyStatus() {
+  const s = notifyStatusObject();
+  console.log('');
+  console.log(`  Voice notification status`);
+  console.log(`  ───────────────────────────`);
+  console.log(`  Claude Stop hook:         ${s.claudeStop ? '✓ installed' : '· not installed'}`);
+  console.log(`  Claude Notification hook: ${s.claudeNotification ? '✓ installed' : '· not installed'}`);
+  console.log(`  Codex notify:             ${s.codex ? '✓ installed' : s.codexForeign ? `! foreign (${s.codexForeign})` : s.codexConfigExists ? '· not installed' : '· no codex config'}`);
+  console.log(`  Script:                   ${s.scriptPath}`);
+  console.log('');
+}
+
+async function promptYesNo(question, defaultYes = true) {
+  if (!process.stdin.isTTY) return defaultYes;
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const suffix = defaultYes ? ' [Y/n] ' : ' [y/N] ';
+  return new Promise((resolve) => {
+    rl.question(question + suffix, (answer) => {
+      rl.close();
+      const a = answer.trim().toLowerCase();
+      if (!a) resolve(defaultYes);
+      else resolve(a === 'y' || a === 'yes');
+    });
+  });
+}
+
+async function offerNotifyDuringInstall() {
+  if (platform() !== 'darwin') return;
+  const s = notifyStatusObject();
+  if (s.claudeStop && s.codex) return; // already wired
+  if (!process.stdin.isTTY) {
+    console.log('');
+    console.log('  Voice notifications available — visit http://localhost:' + PORT + '/settings to enable.');
+    return;
+  }
+  console.log('');
+  const enable = await promptYesNo('Enable voice notifications for Claude Code + Codex?', true);
+  if (!enable) {
+    console.log('  Skipped. You can enable later from http://localhost:' + PORT + '/settings');
+    return;
+  }
+  notifyInstall({ stop: true, notification: false, codex: true });
+}
+
+// ── end voice notifications ──────────────────────────────────────────────
+
 function help() {
   console.log(`
 Vibemeter — local AI coding dashboard
 
 Usage:
-  vibemeter             start the server in the foreground (Ctrl-C to stop)
-  vibemeter install     run on login + keep alive (macOS LaunchAgent)
-  vibemeter uninstall   remove the auto-start config
-  vibemeter status      show whether the daemon is loaded + tail logs
-  vibemeter help        this message
+  vibemeter                  start the server in the foreground (Ctrl-C to stop)
+  vibemeter install          run on login + keep alive (macOS LaunchAgent)
+  vibemeter float            open the desktop floating widget
+  vibemeter uninstall        remove the auto-start config
+  vibemeter status           show whether the daemon is loaded + tail logs
+  vibemeter notify <t> <s>   speak a notification (used by hooks)
+  vibemeter notify-install   wire Vibemeter into Claude Code + Codex
+  vibemeter notify-uninstall remove Vibemeter from Claude Code + Codex
+  vibemeter notify-status    show which voice hooks are installed
+  vibemeter help             this message
 
 Environment:
   PORT                  default ${DEFAULT_PORT}
@@ -205,10 +556,37 @@ switch (cmd) {
     await start();
     break;
   case 'install':
-    if (platform() === 'darwin') macInstall();
+    if (platform() === 'darwin') {
+      macInstall();
+      await offerNotifyDuringInstall();
+    }
     else if (platform() === 'linux') linuxInstallHint();
     else { console.error('Auto-start install not implemented for this platform yet.'); process.exit(1); }
     break;
+  case 'notify': {
+    if (platform() !== 'darwin') {
+      console.error('Voice notifications are macOS-only right now.');
+      process.exit(1);
+    }
+    const tool = process.argv[3] ?? 'AI';
+    const status = process.argv[4] ?? 'complete';
+    const r = spawnSync(NOTIFY_SCRIPT, [tool, status], { stdio: 'inherit' });
+    process.exit(r.status ?? 0);
+  }
+  case 'notify-install':
+    if (platform() !== 'darwin') { console.error('macOS only.'); process.exit(1); }
+    notifyInstall({ stop: true, notification: false, codex: true });
+    break;
+  case 'notify-uninstall':
+    if (platform() !== 'darwin') { console.error('macOS only.'); process.exit(1); }
+    notifyUninstall();
+    break;
+  case 'notify-status':
+    notifyStatus();
+    break;
+  case 'float':
+    openFloat();
+    break;
   case 'uninstall':
     if (platform() === 'darwin') macUninstall();
     else { console.error('Auto-start uninstall not implemented for this platform yet.'); process.exit(1); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hirra/vibemeter",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local-first dashboard for your AI coding life — Claude Code, Codex, Cursor session tracking with usage windows, spending, heatmaps, and achievements.",
   "keywords": [
     "claude-code",
@@ -38,6 +38,7 @@
     "start": "next start",
     "lint": "eslint",
     "typecheck": "tsc --noEmit",
+    "deploy:marketing": "bash scripts/deploy-marketing.sh",
     "prepack": "rm -rf .next && next build && rm -rf .next/cache .next/dev .next/diagnostics .next/trace .next/trace-build .next/turbopack"
   },
   "engines": {

package/.next/server/app/_not-found.html

@@ -1 +0,0 @@
-<!DOCTYPE html><html lang="en" class="geist_a71539c9-module__T19VSG__variable geist_mono_8d43a2aa-module__8Li5zG__variable h-full antialiased"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="/_next/static/chunks/002~6040mndie.css" data-precedence="next"/><link rel="preload" as="script" fetchPriority="low" href="/_next/static/chunks/00gq-v0e07i1q.js"/><script src="/_next/static/chunks/0pqt~8bl3ukh4.js" async=""></script><script src="/_next/static/chunks/02g3221oh~3le.js" async=""></script><script src="/_next/static/chunks/07lhk_q6pmm3r.js" async=""></script><script src="/_next/static/chunks/turbopack-14vio.b1b9i4l.js" async=""></script><script src="/_next/static/chunks/01xlw8hd842-c.js" async=""></script><script src="/_next/static/chunks/0d3shmwh5_nmn.js" async=""></script><meta name="robots" content="noindex"/><meta name="next-size-adjust" content=""/><title>404: This page could not be found.</title><title>Vibemeter</title><meta name="description" content="Measure your AI coding vibe — local-first dashboard for Claude Code, Codex, and Cursor"/><link rel="icon" href="/favicon.ico?favicon.0x3dzn~oxb6tn.ico" sizes="256x256" type="image/x-icon"/><script src="/_next/static/chunks/03~yq9q893hmn.js" noModule=""></script></head><body class="min-h-full flex flex-col"><div hidden=""><!--$--><!--/$--></div><div style="font-family:system-ui,&quot;Segoe UI&quot;,Roboto,Helvetica,Arial,sans-serif,&quot;Apple Color Emoji&quot;,&quot;Segoe UI Emoji&quot;;height:100vh;text-align:center;display:flex;flex-direction:column;align-items:center;justify-content:center"><div><style>body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}</style><h1 class="next-error-h1" style="display:inline-block;margin:0 20px 0 0;padding:0 23px 0 0;font-size:24px;font-weight:500;vertical-align:top;line-height:49px">404</h1><div style="display:inline-block"><h2 style="font-size:14px;font-weight:400;line-height:49px;margin:0">This page could not be found.</h2></div></div></div><!--$--><!--/$--><script src="/_next/static/chunks/00gq-v0e07i1q.js" id="_R_" async=""></script><script>(self.__next_f=self.__next_f||[]).push([0])</script><script>self.__next_f.push([1,"1:\"$Sreact.fragment\"\n2:I[39756,[\"/_next/static/chunks/01xlw8hd842-c.js\",\"/_next/static/chunks/0d3shmwh5_nmn.js\"],\"default\"]\n3:I[37457,[\"/_next/static/chunks/01xlw8hd842-c.js\",\"/_next/static/chunks/0d3shmwh5_nmn.js\"],\"default\"]\n4:I[97367,[\"/_next/static/chunks/01xlw8hd842-c.js\",\"/_next/static/chunks/0d3shmwh5_nmn.js\"],\"OutletBoundary\"]\n5:\"$Sreact.suspense\"\n8:I[97367,[\"/_next/static/chunks/01xlw8hd842-c.js\",\"/_next/static/chunks/0d3shmwh5_nmn.js\"],\"ViewportBoundary\"]\na:I[97367,[\"/_next/static/chunks/01xlw8hd842-c.js\",\"/_next/static/chunks/0d3shmwh5_nmn.js\"],\"MetadataBoundary\"]\nc:I[68027,[\"/_next/static/chunks/01xlw8hd842-c.js\",\"/_next/static/chunks/0d3shmwh5_nmn.js\"],\"default\",1]\n:HL[\"/_next/static/chunks/002~6040mndie.css\",\"style\"]\n"])</script><script>self.__next_f.push([1,"0:{\"P\":null,\"c\":[\"\",\"_not-found\"],\"q\":\"\",\"i\":false,\"f\":[[[\"\",{\"children\":[\"/_not-found\",{\"children\":[\"__PAGE__\",{}]}]},\"$undefined\",\"$undefined\",16],[[\"$\",\"$1\",\"c\",{\"children\":[[[\"$\",\"link\",\"0\",{\"rel\":\"stylesheet\",\"href\":\"/_next/static/chunks/002~6040mndie.css\",\"precedence\":\"next\",\"crossOrigin\":\"$undefined\",\"nonce\":\"$undefined\"}],[\"$\",\"script\",\"script-0\",{\"src\":\"/_next/static/chunks/01xlw8hd842-c.js\",\"async\":true,\"nonce\":\"$undefined\"}],[\"$\",\"script\",\"script-1\",{\"src\":\"/_next/static/chunks/0d3shmwh5_nmn.js\",\"async\":true,\"nonce\":\"$undefined\"}]],[\"$\",\"html\",null,{\"lang\":\"en\",\"className\":\"geist_a71539c9-module__T19VSG__variable geist_mono_8d43a2aa-module__8Li5zG__variable h-full antialiased\",\"children\":[\"$\",\"body\",null,{\"className\":\"min-h-full flex flex-col\",\"children\":[\"$\",\"$L2\",null,{\"parallelRouterKey\":\"children\",\"error\":\"$undefined\",\"errorStyles\":\"$undefined\",\"errorScripts\":\"$undefined\",\"template\":[\"$\",\"$L3\",null,{}],\"templateStyles\":\"$undefined\",\"templateScripts\":\"$undefined\",\"notFound\":[[[\"$\",\"title\",null,{\"children\":\"404: This page could not be found.\"}],[\"$\",\"div\",null,{\"style\":{\"fontFamily\":\"system-ui,\\\"Segoe UI\\\",Roboto,Helvetica,Arial,sans-serif,\\\"Apple Color Emoji\\\",\\\"Segoe UI Emoji\\\"\",\"height\":\"100vh\",\"textAlign\":\"center\",\"display\":\"flex\",\"flexDirection\":\"column\",\"alignItems\":\"center\",\"justifyContent\":\"center\"},\"children\":[\"$\",\"div\",null,{\"children\":[[\"$\",\"style\",null,{\"dangerouslySetInnerHTML\":{\"__html\":\"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}\"}}],[\"$\",\"h1\",null,{\"className\":\"next-error-h1\",\"style\":{\"display\":\"inline-block\",\"margin\":\"0 20px 0 0\",\"padding\":\"0 23px 0 0\",\"fontSize\":24,\"fontWeight\":500,\"verticalAlign\":\"top\",\"lineHeight\":\"49px\"},\"children\":404}],[\"$\",\"div\",null,{\"style\":{\"display\":\"inline-block\"},\"children\":[\"$\",\"h2\",null,{\"style\":{\"fontSize\":14,\"fontWeight\":400,\"lineHeight\":\"49px\",\"margin\":0},\"children\":\"This page could not be found.\"}]}]]}]}]],[]],\"forbidden\":\"$undefined\",\"unauthorized\":\"$undefined\"}]}]}]]}],{\"children\":[[\"$\",\"$1\",\"c\",{\"children\":[null,[\"$\",\"$L2\",null,{\"parallelRouterKey\":\"children\",\"error\":\"$undefined\",\"errorStyles\":\"$undefined\",\"errorScripts\":\"$undefined\",\"template\":[\"$\",\"$L3\",null,{}],\"templateStyles\":\"$undefined\",\"templateScripts\":\"$undefined\",\"notFound\":\"$undefined\",\"forbidden\":\"$undefined\",\"unauthorized\":\"$undefined\"}]]}],{\"children\":[[\"$\",\"$1\",\"c\",{\"children\":[[[\"$\",\"title\",null,{\"children\":\"404: This page could not be found.\"}],[\"$\",\"div\",null,{\"style\":\"$0:f:0:1:0:props:children:1:props:children:props:children:props:notFound:0:1:props:style\",\"children\":[\"$\",\"div\",null,{\"children\":[[\"$\",\"style\",null,{\"dangerouslySetInnerHTML\":{\"__html\":\"body{color:#000;background:#fff;margin:0}.next-error-h1{border-right:1px solid rgba(0,0,0,.3)}@media (prefers-color-scheme:dark){body{color:#fff;background:#000}.next-error-h1{border-right:1px solid rgba(255,255,255,.3)}}\"}}],[\"$\",\"h1\",null,{\"className\":\"next-error-h1\",\"style\":\"$0:f:0:1:0:props:children:1:props:children:props:children:props:notFound:0:1:props:children:props:children:1:props:style\",\"children\":404}],[\"$\",\"div\",null,{\"style\":\"$0:f:0:1:0:props:children:1:props:children:props:children:props:notFound:0:1:props:children:props:children:2:props:style\",\"children\":[\"$\",\"h2\",null,{\"style\":\"$0:f:0:1:0:props:children:1:props:children:props:children:props:notFound:0:1:props:children:props:children:2:props:children:props:style\",\"children\":\"This page could not be found.\"}]}]]}]}]],null,[\"$\",\"$L4\",null,{\"children\":[\"$\",\"$5\",null,{\"name\":\"Next.MetadataOutlet\",\"children\":\"$@6\"}]}]]}],{},null,false,null]},null,false,\"$@7\"]},null,false,null],[\"$\",\"$1\",\"h\",{\"children\":[[\"$\",\"meta\",null,{\"name\":\"robots\",\"content\":\"noindex\"}],[\"$\",\"$L8\",null,{\"children\":\"$L9\"}],[\"$\",\"div\",null,{\"hidden\":true,\"children\":[\"$\",\"$La\",null,{\"children\":[\"$\",\"$5\",null,{\"name\":\"Next.Metadata\",\"children\":\"$Lb\"}]}]}],[\"$\",\"meta\",null,{\"name\":\"next-size-adjust\",\"content\":\"\"}]]}],false]],\"m\":\"$undefined\",\"G\":[\"$c\",[[\"$\",\"link\",\"0\",{\"rel\":\"stylesheet\",\"href\":\"/_next/static/chunks/002~6040mndie.css\",\"precedence\":\"next\",\"crossOrigin\":\"$undefined\",\"nonce\":\"$undefined\"}]]],\"S\":true,\"h\":null,\"s\":\"$undefined\",\"l\":\"$undefined\",\"p\":\"$undefined\",\"d\":\"$undefined\",\"b\":\"Ong62ufsHaRU36s0QK5ZZ\"}\n"])</script><script>self.__next_f.push([1,"d:[]\n7:\"$Wd\"\n"])</script><script>self.__next_f.push([1,"9:[[\"$\",\"meta\",\"0\",{\"charSet\":\"utf-8\"}],[\"$\",\"meta\",\"1\",{\"name\":\"viewport\",\"content\":\"width=device-width, initial-scale=1\"}]]\n"])</script><script>self.__next_f.push([1,"e:I[27201,[\"/_next/static/chunks/01xlw8hd842-c.js\",\"/_next/static/chunks/0d3shmwh5_nmn.js\"],\"IconMark\"]\n6:null\nb:[[\"$\",\"title\",\"0\",{\"children\":\"Vibemeter\"}],[\"$\",\"meta\",\"1\",{\"name\":\"description\",\"content\":\"Measure your AI coding vibe — local-first dashboard for Claude Code, Codex, and Cursor\"}],[\"$\",\"link\",\"2\",{\"rel\":\"icon\",\"href\":\"/favicon.ico?favicon.0x3dzn~oxb6tn.ico\",\"sizes\":\"256x256\",\"type\":\"image/x-icon\"}],[\"$\",\"$Le\",\"3\",{}]]\n"])</script></body></html>