ai-notify 0.4.5 → 0.4.7

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,15 @@ 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 infra vv3        # VOICEVOX スピーカー3（例: ずんだもん）
+ai-notify use clear            # このペインをリセット
+```
+
 ペイン別の上書き — エージェントを起動する**前**に、その端末で `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,15 @@ 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 infra vv3        # VOICEVOX speaker 3 (e.g. ずんだもん)
+ai-notify use clear            # reset this pane
+```
+
 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.5",
+  "version": "0.4.7",
   "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,62 @@ 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]   |   use clear
+  // voice: a system voice name/number (e.g. Kyoko, 3) or VOICEVOX as vv<id> (vv3).
+  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);
+    }
+    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 {
+        const picked = resolveVoice(voiceArg, curatedVoices(10));
+        if (!picked) {
+          console.error(`unknown voice: ${voiceArg}   (names/numbers: ai-notify voice;  VOICEVOX: vv<id>)`);
+          process.exit(1);
+        }
+        patch.tts = 'say';
+        patch.voice = picked;
+        patch.speaker = null;
+        voiceLabel = picked;
+      }
+    }
+    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 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`);
+
+    const bits = [`name ${name}`];
+    if (voiceLabel) bits.push(`voice ${voiceLabel}`);
+    if (patch.volume !== undefined) bits.push(`volume ${patch.volume}`);
+    log(`✓ ${bits.join('  ·  ')}  ·  tab renamed`);
+  },
+
   // 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 +766,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 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

package/src/notify.mjs

@@ -193,7 +193,13 @@ export const emit = ({ provider = 'default', event = 'done', label = '', message
   //   3. the auto-derived label — only when speakLabel is on (else slow filler).
   const envName = (process.env.AI_NOTIFY_LABEL || '').trim();
   const spokenName = envName || pane.speakName || (config.speakLabel === true && label ? label : '');
-  const speakText = spokenName ? `${spokenName}、${spokenBody}` : spokenBody;
+  // Join the pane name to the read-out as the SUBJECT. Japanese needs the は
+  // topic particle ("ジョンは、…") — a bare comma ("ジョン、…") reads as calling
+  // out TO John, not saying John is the one finishing / waiting. Other languages
+  // just get a comma.
+  const isJa = (s) => /[぀-ヿ㐀-鿿ｦ-ﾟ]/.test(s); // kana / kanji / half-width kana
+  const joinName = (name, body) => (name ? `${name}${isJa(body) ? 'は、' : ', '}${body}` : body);
+  const speakText = joinName(spokenName, spokenBody);
 
   // Per-pane voice (precedence: $AI_NOTIFY_* env > this pane's pick > global).
   const tts = pane.tts || config.tts;
@@ -238,7 +244,7 @@ export const emit = ({ provider = 'default', event = 'done', label = '', message
     speakTone = tsundere.axisFor(eff);
     outVol = Math.min(2, Math.max(0, vol * tsundere.volumeMul(tier, ts.volumeBoost !== false)));
     outText = tsundere.wrap(spokenBody, eff, tier, ts.lang || 'ja', nextCounter('tsundere'));
-    if (spokenName) outText = `${spokenName}、${outText}`;
+    if (spokenName) outText = joinName(spokenName, outText);
     if (tts === 'voicevox') {
       const sm = ts.styleMap || voicevox.resolveStyles(outSpeaker, config.voicevox?.url);
       const axis = tsundere.axisFor(eff);