ai-notify 0.4.7 → 0.4.8

package/README.ja.md

@@ -66,12 +66,15 @@ ai-notify uninstall                                # 配線をきれいに削除
 **ペインの設定を1コマンドで。** エージェントを動かす端末の中でこれを実行すると、読み上げ名・声・音量・**ターミナルのタブ名**を一度に設定できます。メニュー操作は不要：
 
 ```sh
-ai-notify use api Kyoko        # 名前「api」＋声 Kyoko＋タブ名→api
-ai-notify use web Eddy 0.8     # ＋音量 0.8
-ai-notify use infra vv3        # VOICEVOX スピーカー3（例: ずんだもん）
-ai-notify use clear            # このペインをリセット
+ai-notify use api Kyoko                       # 名前「api」＋声 Kyoko＋タブ名→api
+ai-notify use web Eddy 0.8                    # ＋音量 0.8
+ai-notify use zunda ずんだもん                 # 声は VOICEVOX キャラ名で指定（vv3 でも可）
+ai-notify use エックスズンダモン ずんだもん --tab x_zunda   # 読み上げ名とタブ名を別々に
+ai-notify use clear                           # このペインをリセット
 ```
 
+`声` は `say` の名前/番号（`Kyoko`・`3`）、VOICEVOX の**キャラ名**（`ずんだもん`）、`vv<id>`（`vv3`）が使えます。`--tab` で読み上げ名と別のタブ名を付けられます。
+
 ペイン別の上書き — エージェントを起動する**前**に、その端末で `export` する：
 
 ```sh

package/README.md

@@ -67,12 +67,15 @@ ai-notify uninstall                                # cleanly remove wiring
 **Set up a pane in one command.** Run this *in* the terminal where the agent runs — it names the pane (spoken in the read-out), picks its voice, sets its volume, and renames the terminal tab, all at once. No menu hopping:
 
 ```sh
-ai-notify use api Kyoko        # name "api" + voice Kyoko + tab → "api"
-ai-notify use web Eddy 0.8     # + volume 0.8
-ai-notify use infra vv3        # VOICEVOX speaker 3 (e.g. ずんだもん)
-ai-notify use clear            # reset this pane
+ai-notify use api Kyoko                       # name "api" + voice Kyoko + tab → "api"
+ai-notify use web Eddy 0.8                    # + volume 0.8
+ai-notify use zunda ずんだもん                 # voice by VOICEVOX character name (or vv3)
+ai-notify use エックスズンダモン ずんだもん --tab x_zunda   # spoken name ≠ tab title
+ai-notify use clear                           # reset this pane
 ```
 
+`voice` is a `say` name/number (`Kyoko`, `3`), a VOICEVOX **character name** (`ずんだもん`), or `vv<id>` (`vv3`). `--tab` sets a different terminal tab title from the spoken name.
+
 Per-window overrides — `export` these in a terminal *before* launching the agent:
 
 ```sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-notify",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "Desktop, sound, and spoken notifications for terminal AI coding agents (Claude Code, Codex, Gemini, ...) — with one mute switch that covers all of them, across every terminal.",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -510,15 +510,28 @@ const cmds = {
   // and volume — and rename the terminal tab — in a single command, instead of
   // doing each from the menu bar. Keyed by this shell's tty (which the agent's
   // hook resolves to as well), so it just works for the agent running here.
-  //   use <name> [voice] [volume]   |   use clear
-  // voice: a system voice name/number (e.g. Kyoko, 3) or VOICEVOX as vv<id> (vv3).
+  //   use <name> [voice] [volume] [--tab <title>]   |   use clear
+  // voice: a system voice name/number (Kyoko, 3), a VOICEVOX character name
+  //        (ずんだもん), or vv<id> (vv3).  --tab: separate tab title (default <name>).
   use() {
-    const [name, voiceArg, volArg] = positionals;
     const tty = controllingTty();
     if (!tty) {
       console.error('`ai-notify use` must run inside a terminal pane (no controlling tty found).');
       process.exit(1);
     }
+    // Pull --tab and its value out first, so the tab title (any token) is never
+    // mistaken for the voice or volume positional.
+    const rest = args.slice(1);
+    let tabTitle;
+    const pos = [];
+    for (let i = 0; i < rest.length; i++) {
+      if (rest[i] === '--tab') {
+        if (rest[i + 1] && !rest[i + 1].startsWith('--')) tabTitle = rest[++i];
+        continue;
+      }
+      if (!rest[i].startsWith('--')) pos.push(rest[i]);
+    }
+    const [name, voiceArg, volArg] = pos;
     if (!name || name === 'clear' || name === 'reset') {
       updatePaneSetting(tty, { speakName: null, tts: null, voice: null, speaker: null, volume: null });
       process.stdout.write('\u001b]0;\u0007'); // clear the tab title (best-effort)
@@ -534,16 +547,28 @@ const cmds = {
         patch.speaker = Number(vv[1]);
         patch.voice = null;
         voiceLabel = `VOICEVOX ${vv[1]}`;
+      } else if (resolveVoice(voiceArg, curatedVoices(10))) {
+        patch.tts = 'say';
+        patch.voice = resolveVoice(voiceArg, curatedVoices(10));
+        patch.speaker = null;
+        voiceLabel = patch.voice;
       } else {
-        const picked = resolveVoice(voiceArg, curatedVoices(10));
-        if (!picked) {
-          console.error(`unknown voice: ${voiceArg}   (names/numbers: ai-notify voice;  VOICEVOX: vv<id>)`);
+        // A VOICEVOX character by name (e.g. ずんだもん) — resolve via the engine.
+        const url = readConfig().voicevox?.url || voicevox.DEFAULT_URL;
+        const chars = voicevox.isAvailable(url) ? voicevox.listCharacters(url) : [];
+        const hit = chars.find((c) => c.name === voiceArg) || chars.find((c) => c.name.includes(voiceArg));
+        if (!hit) {
+          console.error(
+            `unknown voice: ${voiceArg}\n` +
+              '  say voice: a name/number from `ai-notify voice` (e.g. Kyoko, 3)\n' +
+              '  VOICEVOX:  a character name (e.g. ずんだもん; engine must be running) or vv<id> (vv3)'
+          );
           process.exit(1);
         }
-        patch.tts = 'say';
-        patch.voice = picked;
-        patch.speaker = null;
-        voiceLabel = picked;
+        patch.tts = 'voicevox';
+        patch.speaker = hit.id;
+        patch.voice = null;
+        voiceLabel = `${hit.name} (VOICEVOX ${hit.id})`;
       }
     }
     if (volArg !== undefined) {
@@ -552,14 +577,16 @@ const cmds = {
     }
 
     updatePaneSetting(tty, patch);
-    // Rename this terminal tab/window to the pane name (best-effort — a shell
-    // that rewrites the title on each prompt may override it after you return).
-    process.stdout.write(`\u001b]0;${name}\u0007`);
+    // Rename this terminal tab/window (best-effort — a shell that rewrites the
+    // title on each prompt may override it after you return to the prompt).
+    const tab = tabTitle || name;
+    process.stdout.write(`\u001b]0;${tab}\u0007`);
 
     const bits = [`name ${name}`];
     if (voiceLabel) bits.push(`voice ${voiceLabel}`);
     if (patch.volume !== undefined) bits.push(`volume ${patch.volume}`);
-    log(`✓ ${bits.join('  ·  ')}  ·  tab renamed`);
+    bits.push(`tab ${tab}`);
+    log(`✓ ${bits.join('  ·  ')}`);
   },
 
   // Get/set the VOICEVOX base prosody (the normal-tone scales the menu bar
@@ -766,7 +793,7 @@ function printHelp() {
 Usage:
   ai-notify init [--dry-run] [--only claude,codex]   wire detected agents
   ai-notify uninstall [--only ...]                   remove wiring
-  ai-notify use <name> [voice] [vol]                 name THIS pane + set its voice + rename the tab, at once
+  ai-notify use <name> [voice] [vol] [--tab <t>]     name THIS pane + voice + tab, at once (voice: Kyoko | 3 | ずんだもん | vv3)
   ai-notify toggle | on | off | status               control the mute switch
   ai-notify volume [0.0-2.0]                          get/set output volume
   ai-notify voice [number|name|preview|default]      pick the spoken voice