ai-notify 0.4.6 → 0.4.8

package/README.ja.md

@@ -51,6 +51,7 @@ ai-notify init        # インストール済みのエージェントを自動
 
 ```sh
 ai-notify init [--dry-run] [--only claude,codex]   # 検出したエージェントを配線
+ai-notify use <名前> [声] [音量]                    # このペインの名前＋声＋タブ名を一括設定
 ai-notify toggle | on | off | status               # ミュートスイッチ
 ai-notify volume [0.0-2.0]                          # 音量の取得／設定
 ai-notify voice [number|name|preview|default]      # 読み上げ音声を選ぶ
@@ -62,6 +63,18 @@ ai-notify doctor                                   # 依存・配線の確認
 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 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

@@ -52,6 +52,7 @@ Adding another agent (aider, opencode, amp, …) is a small PR: drop a file in `
 
 ```sh
 ai-notify init [--dry-run] [--only claude,codex]   # wire detected agents
+ai-notify use <name> [voice] [vol]                 # set THIS pane's name + voice + tab title, in one go
 ai-notify toggle | on | off | status               # 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
@@ -63,6 +64,18 @@ ai-notify doctor                                   # check deps & wiring
 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 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.6",
+  "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

@@ -6,7 +6,7 @@ import { readFileSync } from 'node:fs';
 import { execSync, execFileSync } from 'node:child_process';
 import { providers, byId } from './providers/index.mjs';
 import { emit } from './notify.mjs';
-import { deriveLabel, cliInvocation, isEphemeralInstall } from './util.mjs';
+import { deriveLabel, cliInvocation, isEphemeralInstall, controllingTty } from './util.mjs';
 import { curatedVoices, resolveVoice, previewVoice } from './voices.mjs';
 import * as menubar from './menubar.mjs';
 import { translate } from './translate.mjs';
@@ -506,6 +506,89 @@ const cmds = {
     log(`pane ${tty}: name ${arg}`);
   },
 
+  // One-shot per-pane setup, run INSIDE the pane: set its spoken name, voice,
+  // 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] [--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 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)
+      return log(`✓ pane reset (${tty})`);
+    }
+
+    const patch = { speakName: name };
+    let voiceLabel = '';
+    if (voiceArg !== undefined) {
+      const vv = /^(?:vv|voicevox):?(\d+)$/i.exec(voiceArg);
+      if (vv) {
+        patch.tts = 'voicevox';
+        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 {
+        // 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 = 'voicevox';
+        patch.speaker = hit.id;
+        patch.voice = null;
+        voiceLabel = `${hit.name} (VOICEVOX ${hit.id})`;
+      }
+    }
+    if (volArg !== undefined) {
+      const v = Number(volArg);
+      if (Number.isFinite(v)) patch.volume = Math.min(2, Math.max(0, v));
+    }
+
+    updatePaneSetting(tty, patch);
+    // 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}`);
+    bits.push(`tab ${tab}`);
+    log(`✓ ${bits.join('  ·  ')}`);
+  },
+
   // Get/set the VOICEVOX base prosody (the normal-tone scales the menu bar
   // sliders drive). With no args, prints the current values as JSON.
   //   voice-prosody [speed|pitch|intonation <value> | reset]
@@ -710,6 +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] [--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