claude-notification-plugin 1.0.4 → 1.0.10

package/README.md

@@ -7,9 +7,9 @@ Notifications for Claude Code task completion. Sends alerts to Telegram and Wind
 - Windows desktop notifications (toast)
 - Telegram bot messages
 - Sound alert
-- Voice announcement
+- Voice announcement (TTS)
 - Skips short tasks (< 15s by default)
-- Per-project disable
+- Granular per-channel enable/disable (globally and per-project)
 
 ## Install
 
@@ -30,8 +30,13 @@ Config file: `~/.claude/notifier.config.json`
 ```json
 {
   "telegram": {
+    "enabled": true,
     "token": "YOUR_BOT_TOKEN",
-    "chatId": "YOUR_CHAT_ID"
+    "chatId": "YOUR_CHAT_ID",
+    "deleteAfterHours": 24
+  },
+  "windowsNotification": {
+    "enabled": true
   },
   "sound": {
     "enabled": true,
@@ -44,11 +49,40 @@ Config file: `~/.claude/notifier.config.json`
 }
 ```
 
+Each channel has an `enabled` flag (`true`/`false`) for global control.
+
+`deleteAfterHours` — auto-delete old Telegram messages after the specified number of hours (default: `24`, set `0` to disable).
+
 Environment variables `TELEGRAM_TOKEN` and `TELEGRAM_CHAT_ID` override config file values.
 
-### Disable per project
+### Per-channel environment variables
+
+These env vars override the global config per channel (`"1"` = on, `"0"` = off):
+
+| Variable                 | Channel                    |
+|--------------------------|----------------------------|
+| `CLAUDE_NOTIFY_TELEGRAM` | Telegram messages          |
+| `CLAUDE_NOTIFY_WINDOWS`  | Windows toast notifications|
+| `CLAUDE_NOTIFY_SOUND`    | Sound alert                |
+| `CLAUDE_NOTIFY_VOICE`    | Voice announcement (TTS)   |
+
+### Per-project configuration
+
+Add to `.claude/settings.local.json` in the project root to control channels per project:
+
+```json
+{
+  "env": {
+    "DISABLE_CLAUDE_NOTIFIER": 0,
+    "CLAUDE_NOTIFY_TELEGRAM": 1,
+    "CLAUDE_NOTIFY_WINDOWS": 1,
+    "CLAUDE_NOTIFY_SOUND": 1,
+    "CLAUDE_NOTIFY_VOICE": 1
+  }
+}
+```
 
-Add to `.claude/settings.local.json` in the project root:
+To disable all notifications for a project:
 
 ```json
 {
@@ -63,7 +97,7 @@ Add to `.claude/settings.local.json` in the project root:
 1. Open Telegram, find **@BotFather**
 2. Send `/newbot`, follow prompts, pick a name
 3. Copy the bot token (format: `123456789:ABCdef...`)
-4. Send any message to your new bot
+4. **Send any message to your new bot**
 5. Open `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`
 6. Find `"chat":{"id":123456789}` in the response — that's your Chat ID
 7. Run `claude-notify-install` and enter the token and chat ID

package/bin/install.js

@@ -112,9 +112,22 @@ async function main () {
   fs.mkdirSync(claudeDir, { recursive: true });
 
   const config = {
-    telegram: { token, chatId },
-    sound: { enabled: true, file: 'C:/Windows/Media/notify.wav' },
-    voice: { enabled: true },
+    telegram: {
+      enabled: true,
+      token,
+      chatId,
+      deleteAfterHours: 24,
+    },
+    windowsNotification: {
+      enabled: true,
+    },
+    sound: {
+      enabled: true,
+      file: 'C:/Windows/Media/notify.wav',
+    },
+    voice: {
+      enabled: true,
+    },
     minSeconds: 15,
   };
 

package/notifier/notifier.js

@@ -18,9 +18,22 @@ function loadConfig () {
   const configPath = path.join(os.homedir(), '.claude', 'notifier.config.json');
 
   const config = {
-    telegram: { token: '', chatId: '' },
-    sound: { enabled: true, file: 'C:/Windows/Media/notify.wav' },
-    voice: { enabled: true },
+    telegram: {
+      enabled: true,
+      token: '',
+      chatId: '',
+      deleteAfterHours: 24,
+    },
+    windowsNotification: {
+      enabled: true,
+    },
+    sound: {
+      enabled: true,
+      file: 'C:/Windows/Media/notify.wav',
+    },
+    voice: {
+      enabled: true,
+    },
     minSeconds: 15,
   };
 
@@ -31,6 +44,9 @@ function loadConfig () {
       if (user.telegram) {
         config.telegram = { ...config.telegram, ...user.telegram };
       }
+      if (user.windowsNotification) {
+        config.windowsNotification = { ...config.windowsNotification, ...user.windowsNotification };
+      }
       if (user.sound) {
         config.sound = { ...config.sound, ...user.sound };
       }
@@ -52,6 +68,20 @@ function loadConfig () {
     config.telegram.chatId = process.env.TELEGRAM_CHAT_ID;
   }
 
+  // Per-channel env overrides (0 = off, 1 = on)
+  if (process.env.CLAUDE_NOTIFY_TELEGRAM !== undefined) {
+    config.telegram.enabled = process.env.CLAUDE_NOTIFY_TELEGRAM === '1';
+  }
+  if (process.env.CLAUDE_NOTIFY_WINDOWS !== undefined) {
+    config.windowsNotification.enabled = process.env.CLAUDE_NOTIFY_WINDOWS === '1';
+  }
+  if (process.env.CLAUDE_NOTIFY_SOUND !== undefined) {
+    config.sound.enabled = process.env.CLAUDE_NOTIFY_SOUND === '1';
+  }
+  if (process.env.CLAUDE_NOTIFY_VOICE !== undefined) {
+    config.voice.enabled = process.env.CLAUDE_NOTIFY_VOICE === '1';
+  }
+
   return config;
 }
 
@@ -95,33 +125,72 @@ function saveState (state) {
 // TELEGRAM
 // ----------------------
 
-async function sendTelegram (config, text) {
-  if (!config.telegram.token || !config.telegram.chatId) {
+async function sendTelegram (config, state) {
+  if (!config.telegram.enabled || !config.telegram.token || !config.telegram.chatId) {
     return;
   }
 
-  const url =
-    `https://api.telegram.org/bot${config.telegram.token}/sendMessage`;
+  const baseUrl = `https://api.telegram.org/bot${config.telegram.token}`;
 
+  // Send new message and store its id
   try {
-    await fetch(url, {
+    const res = await fetch(`${baseUrl}/sendMessage`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({
         chat_id: config.telegram.chatId,
-        text,
+        text: state._telegramText,
       }),
     });
+    const data = await res.json();
+    if (data.ok && data.result?.message_id) {
+      if (!state.sentMessages) {
+        state.sentMessages = [];
+      }
+      state.sentMessages.push({
+        id: data.result.message_id,
+        ts: Date.now(),
+      });
+    }
   } catch {
     // silent fail
   }
+
+  // Delete old messages
+  const maxAge = (config.telegram.deleteAfterHours || 24) * 3600_000;
+  if (state.sentMessages?.length) {
+    const now = Date.now();
+    const keep = [];
+    for (const msg of state.sentMessages) {
+      if (now - msg.ts > maxAge) {
+        try {
+          await fetch(`${baseUrl}/deleteMessage`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+              chat_id: config.telegram.chatId,
+              message_id: msg.id,
+            }),
+          });
+        } catch {
+          // silent fail
+        }
+      } else {
+        keep.push(msg);
+      }
+    }
+    state.sentMessages = keep;
+  }
 }
 
 // ----------------------
 // WINDOWS NOTIFICATION
 // ----------------------
 
-function sendWindowsNotification (message) {
+function sendWindowsNotification (config, message) {
+  if (!config.windowsNotification.enabled) {
+    return;
+  }
   notifier.notify({
     title: 'Claude Code',
     message,
@@ -145,12 +214,30 @@ function playSound (config) {
   }
 }
 
+const voicePhrases = {
+  en: (d) => `Claude finished coding in ${d} seconds`,
+  ru: (d) => `Клод завершил работу за ${d} секунд`,
+  de: (d) => `Claude hat die Arbeit in ${d} Sekunden abgeschlossen`,
+  fr: (d) => `Claude a termine en ${d} secondes`,
+  es: (d) => `Claude termino en ${d} segundos`,
+  pt: (d) => `Claude terminou em ${d} segundos`,
+  ja: (d) => `Claudeは${d}秒でコーディングを完了しました`,
+  ko: (d) => `Claude가 ${d}초 만에 코딩을 완료했습니다`,
+};
+
+function getVoicePhrase (duration) {
+  const locale = Intl.DateTimeFormat().resolvedOptions().locale || 'en';
+  const lang = locale.split('-')[0].toLowerCase();
+  const fn = voicePhrases[lang] || voicePhrases.en;
+  return fn(duration);
+}
+
 function speakResult (config, duration) {
   if (!config.voice.enabled) {
     return;
   }
   try {
-    say.speak(`Claude finished coding in ${duration} seconds`);
+    say.speak(getVoicePhrase(duration));
   } catch {
     // silent fail
   }
@@ -224,8 +311,12 @@ process.stdin.on('end', async () => {
   const message =
     `Claude finished coding\n\nProject: ${project}\nDuration: ${duration}s\nStatus: ${status}`;
 
-  await sendTelegram(config, `\u{1F916} ${message}`);
-  sendWindowsNotification(message);
+  state._telegramText = `\u{1F916} ${message}`;
+  await sendTelegram(config, state);
+  delete state._telegramText;
+  saveState(state);
+
+  sendWindowsNotification(config, message);
   playSound(config);
   speakResult(config, duration);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-notification-plugin",
   "productName": "claude-notification-plugin",
-  "version": "1.0.4",
+  "version": "1.0.10",
   "description": "Telegram and Windows notifications for Claude Code task completion",
   "type": "module",
   "engines": {