claude-notification-plugin 1.0.4 → 1.0.6

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,9 +30,13 @@ Config file: `~/.claude/notifier.config.json`
 ```json
 {
   "telegram": {
+    "enabled": true,
     "token": "YOUR_BOT_TOKEN",
     "chatId": "YOUR_CHAT_ID"
   },
+  "windowsNotification": {
+    "enabled": true
+  },
   "sound": {
     "enabled": true,
     "file": "C:/Windows/Media/notify.wav"
@@ -44,11 +48,38 @@ Config file: `~/.claude/notifier.config.json`
 }
 ```
 
+Each channel has an `enabled` flag (`true`/`false`) for global control.
+
 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 +94,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,7 +112,8 @@ async function main () {
   fs.mkdirSync(claudeDir, { recursive: true });
 
   const config = {
-    telegram: { token, chatId },
+    telegram: { enabled: true, token, chatId },
+    windowsNotification: { enabled: true },
     sound: { enabled: true, file: 'C:/Windows/Media/notify.wav' },
     voice: { enabled: true },
     minSeconds: 15,

package/notifier/notifier.js

@@ -18,7 +18,8 @@ function loadConfig () {
   const configPath = path.join(os.homedir(), '.claude', 'notifier.config.json');
 
   const config = {
-    telegram: { token: '', chatId: '' },
+    telegram: { enabled: true, token: '', chatId: '' },
+    windowsNotification: { enabled: true },
     sound: { enabled: true, file: 'C:/Windows/Media/notify.wav' },
     voice: { enabled: true },
     minSeconds: 15,
@@ -31,6 +32,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 +56,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;
 }
 
@@ -96,7 +114,7 @@ function saveState (state) {
 // ----------------------
 
 async function sendTelegram (config, text) {
-  if (!config.telegram.token || !config.telegram.chatId) {
+  if (!config.telegram.enabled || !config.telegram.token || !config.telegram.chatId) {
     return;
   }
 
@@ -121,7 +139,10 @@ async function sendTelegram (config, text) {
 // WINDOWS NOTIFICATION
 // ----------------------
 
-function sendWindowsNotification (message) {
+function sendWindowsNotification (config, message) {
+  if (!config.windowsNotification.enabled) {
+    return;
+  }
   notifier.notify({
     title: 'Claude Code',
     message,
@@ -225,7 +246,7 @@ process.stdin.on('end', async () => {
     `Claude finished coding\n\nProject: ${project}\nDuration: ${duration}s\nStatus: ${status}`;
 
   await sendTelegram(config, `\u{1F916} ${message}`);
-  sendWindowsNotification(message);
+  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.6",
   "description": "Telegram and Windows notifications for Claude Code task completion",
   "type": "module",
   "engines": {