ai-notify 0.4.7 → 0.4.9

package/README.ja.md

@@ -66,12 +66,17 @@ 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` で読み上げ名と別のタブ名を付けられます。
+
+> タブ名の変更はベストエフォートで、標準のタイトルエスケープ（OSC 0＋2）を送ります。**Terminal.app** と **iTerm2** は反映します。**JetBrains 系（WebStorm/IntelliJ）は新ターミナル（Reworked・2025.2 以降が既定）でのみ反映**し、バージョンによってはタブを再アクティブにすると名前が戻ります（[IDEA-277846](https://youtrack.jetbrains.com/issue/IDEA-277846/Support-changing-terminal-tab-title-by-escape-sequences)）。プロンプト毎にタイトルを書き換えるシェル設定でも上書きされます。読み上げ名と声は端末に関係なく常に有効です。
+
 ペイン別の上書き — エージェントを起動する**前**に、その端末で `export` する：
 
 ```sh

package/README.md

@@ -67,12 +67,17 @@ 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.
+
+> Tab renaming is best-effort — it sends the standard title escape (OSC 0 + 2), which **Terminal.app** and **iTerm2** honor. **JetBrains IDEs** (WebStorm/IntelliJ) honor it only with the **Reworked terminal** (default in 2025.2+); some versions reset the name when you re-activate the tab ([IDEA-277846](https://youtrack.jetbrains.com/issue/IDEA-277846/Support-changing-terminal-tab-title-by-escape-sequences)). A shell that rewrites the title every prompt can also override it. The spoken name and voice always apply regardless.
+
 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.9",
   "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,18 +510,31 @@ 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)
+      process.stdout.write('\u001b]0;\u0007\u001b]2;\u0007'); // clear tab title via OSC 0 + 2 (best-effort)
       return log(`✓ pane reset (${tty})`);
     }
 
@@ -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\u001b]2;${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