claude-notification-plugin 1.0.47 → 1.0.50

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-notification-plugin",
-  "version": "1.0.47",
-  "description": "Claude Code notifications щт task completion: Telegram, Windows toast, sound, and voice",
+  "version": "1.0.50",
+  "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
   "author": {
     "name": "Viacheslav Makarov",
     "email": "npmjs@bazilio.ru"

package/README.md

@@ -1,13 +1,13 @@
 # claude-notification-plugin
 
-Notifications for Claude Code task completion. Sends alerts to Telegram and Windows when Claude finishes working.
+Cross-platform notifications for Claude Code task completion. Sends alerts to Telegram and desktop (Windows, macOS, Linux) when Claude finishes working.
 
 ## Features
 
-- Windows desktop notifications (toast)
+- Desktop notifications (Windows toast, macOS Notification Center, Linux notify-send)
 - Telegram bot messages with auto-delete
-- Sound alert (hidden PowerShell, no popup windows)
-- Voice announcement with number-to-words and pluralization (EN, RU)
+- Sound alert (Windows: PowerShell, macOS: afplay, Linux: paplay/aplay)
+- Voice announcement with number-to-words and pluralization (EN, RU) (Windows: SAPI, macOS: say, Linux: spd-say/espeak)
 - Separate notifications for task completion and waiting-for-input events
 - Skips short tasks (< 15s by default)
 - Granular per-channel enable/disable (globally and per-project)
@@ -71,12 +71,12 @@ Config file: `~/.claude/notifier.config.json`
     "deleteAfterHours": 24,
     "includeLastCcMessageInTelegram": true
   },
-  "windowsNotification": {
+  "desktopNotification": {
     "enabled": true
   },
   "sound": {
     "enabled": true,
-    "file": "C:/Windows/Media/notify.wav"
+    "file": ""
   },
   "voice": {
     "enabled": true
@@ -89,6 +89,8 @@ Config file: `~/.claude/notifier.config.json`
 
 Each channel has an `enabled` flag (`true`/`false`) for global control.
 
+`sound.file` — path to a sound file. Leave empty for platform default (Windows: `C:/Windows/Media/notify.wav`, macOS: `/System/Library/Sounds/Glass.aiff`, Linux: `/usr/share/sounds/freedesktop/stereo/complete.oga`).
+
 `deleteAfterHours` — auto-delete old Telegram messages after the specified number of hours (default: `24`, set `0` to disable).
 
 `includeLastCcMessageInTelegram` — append Claude's last assistant message to the Telegram notification (default: `true`). Only affects Telegram, not Windows toast notifications. Long messages are truncated to 3500 characters.
@@ -106,7 +108,7 @@ 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_DESKTOP`  | Desktop notifications      |
 | `CLAUDE_NOTIFY_SOUND`    | Sound alert                |
 | `CLAUDE_NOTIFY_VOICE`    | Voice announcement (TTS)   |
 | `CLAUDE_NOTIFY_WAITING`  | Waiting-for-input events   |
@@ -122,7 +124,7 @@ Add to `.claude/settings.local.json` in the project root to control channels per
   "env": {
     "DISABLE_CLAUDE_NOTIFIER": 0,
     "CLAUDE_NOTIFY_TELEGRAM": 1,
-    "CLAUDE_NOTIFY_WINDOWS": 1,
+    "CLAUDE_NOTIFY_DESKTOP": 1,
     "CLAUDE_NOTIFY_SOUND": 1,
     "CLAUDE_NOTIFY_VOICE": 1,
     "CLAUDE_NOTIFY_WAITING": 1,

package/bin/install.js

@@ -136,6 +136,14 @@ async function main () {
   // Create / update config
   fs.mkdirSync(claudeDir, { recursive: true });
 
+  const platform = process.platform;
+  let defaultSoundFile;
+  switch (platform) {
+    case 'darwin': defaultSoundFile = '/System/Library/Sounds/Glass.aiff'; break;
+    case 'linux': defaultSoundFile = '/usr/share/sounds/freedesktop/stereo/complete.oga'; break;
+    default: defaultSoundFile = 'C:/Windows/Media/notify.wav';
+  }
+
   const defaults = {
     telegram: {
       enabled: true,
@@ -143,12 +151,12 @@ async function main () {
       chatId: '',
       deleteAfterHours: 24,
     },
-    windowsNotification: {
+    desktopNotification: {
       enabled: true,
     },
     sound: {
       enabled: true,
-      file: 'C:/Windows/Media/notify.wav',
+      file: defaultSoundFile,
     },
     voice: {
       enabled: true,
@@ -213,6 +221,18 @@ async function main () {
     console.log('Telegram: not configured (edit config later)');
   }
 
+  if (platform === 'darwin') {
+    console.log('');
+    console.log('Tip: install terminal-notifier for better macOS notifications:');
+    console.log('  brew install terminal-notifier');
+  }
+
+  if (platform === 'linux') {
+    console.log('');
+    console.log('Tip: for voice announcements, install espeak:');
+    console.log('  sudo apt install espeak');
+  }
+
   console.log('');
   console.log('To disable per project, add to .claude/settings.local.json:');
   console.log('  { "env": { "DISABLE_CLAUDE_NOTIFIER": "1" } }');

package/notifier/notifier.js

@@ -10,6 +10,22 @@ import { spawn } from 'child_process';
 // CONFIG
 // ----------------------
 
+const PLATFORM = process.platform; // 'win32' | 'darwin' | 'linux'
+
+function getDefaultSoundFile () {
+  switch (PLATFORM) {
+    case 'darwin': return '/System/Library/Sounds/Glass.aiff';
+    case 'linux': return '/usr/share/sounds/freedesktop/stereo/complete.oga';
+    default: return 'C:/Windows/Media/notify.wav';
+  }
+}
+
+function debugLog (config, ...args) {
+  if (config.debug) {
+    console.error('[claude-notifier]', ...args);
+  }
+}
+
 function loadConfig () {
   const configPath = path.join(os.homedir(), '.claude', 'notifier.config.json');
 
@@ -21,12 +37,12 @@ function loadConfig () {
       deleteAfterHours: 24,
       includeLastCcMessageInTelegram: true,
     },
-    windowsNotification: {
+    desktopNotification: {
       enabled: true,
     },
     sound: {
       enabled: true,
-      file: 'C:/Windows/Media/notify.wav',
+      file: getDefaultSoundFile(),
     },
     voice: {
       enabled: true,
@@ -43,8 +59,8 @@ function loadConfig () {
       if (user.telegram) {
         config.telegram = { ...config.telegram, ...user.telegram };
       }
-      if (user.windowsNotification) {
-        config.windowsNotification = { ...config.windowsNotification, ...user.windowsNotification };
+      if (user.desktopNotification) {
+        config.desktopNotification = { ...config.desktopNotification, ...user.desktopNotification };
       }
       if (user.sound) {
         config.sound = { ...config.sound, ...user.sound };
@@ -77,8 +93,8 @@ function loadConfig () {
   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_DESKTOP !== undefined) {
+    config.desktopNotification.enabled = process.env.CLAUDE_NOTIFY_DESKTOP === '1';
   }
   if (process.env.CLAUDE_NOTIFY_SOUND !== undefined) {
     config.sound.enabled = process.env.CLAUDE_NOTIFY_SOUND === '1';
@@ -271,11 +287,32 @@ async function sendTelegram (config, state) {
 }
 
 // ----------------------
-// WINDOWS NOTIFICATION
+// DESKTOP NOTIFICATION
 // ----------------------
 
-async function sendWindowsNotification (config, message) {
-  if (!config.windowsNotification.enabled) {
+function sendNativeFallback (config, message) {
+  try {
+    switch (PLATFORM) {
+      case 'darwin': {
+        const escaped = message.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        spawn('osascript', ['-e', `display notification "${escaped}" with title "Claude Code"`], {
+          stdio: 'ignore',
+        });
+        break;
+      }
+      case 'linux':
+        spawn('notify-send', ['Claude Code', message], {
+          stdio: 'ignore',
+        });
+        break;
+    }
+  } catch (err) {
+    debugLog(config, 'native notification fallback failed:', err.message);
+  }
+}
+
+async function sendDesktopNotification (config, message) {
+  if (!config.desktopNotification.enabled) {
     return;
   }
   try {
@@ -283,11 +320,12 @@ async function sendWindowsNotification (config, message) {
     notifier.notify({
       title: 'Claude Code',
       message,
-      sound: true,
+      sound: false,
       wait: false,
     });
-  } catch {
-    // node-notifier not available (e.g. plugin cache without node_modules)
+  } catch (err) {
+    debugLog(config, 'node-notifier failed, trying native fallback:', err.message);
+    sendNativeFallback(config, message);
   }
 }
 
@@ -299,15 +337,30 @@ function playSound (config) {
   if (!config.sound.enabled) {
     return;
   }
+  const file = config.sound.file;
   try {
-    const file = config.sound.file.replace(/'/g, "''");
-    const psCommand = `(New-Object Media.SoundPlayer '${file}').PlaySync()`;
-    spawn('powershell', ['-Command', psCommand], {
-      stdio: 'ignore',
-      windowsHide: true,
-    });
-  } catch {
-    // silent fail
+    switch (PLATFORM) {
+      case 'win32': {
+        const psCommand = `(New-Object Media.SoundPlayer '${file.replace(/'/g, "''")}').PlaySync()`;
+        spawn('powershell', ['-Command', psCommand], {
+          stdio: 'ignore',
+          windowsHide: true,
+        });
+        break;
+      }
+      case 'darwin':
+        spawn('afplay', [file], { stdio: 'ignore' });
+        break;
+      case 'linux': {
+        const child = spawn('paplay', [file], { stdio: 'ignore' });
+        child.on('error', () => {
+          spawn('aplay', [file], { stdio: 'ignore' });
+        });
+        break;
+      }
+    }
+  } catch (err) {
+    debugLog(config, 'playSound failed:', err.message);
   }
 }
 
@@ -446,19 +499,34 @@ function speakResult (config, duration) {
   if (!config.voice.enabled) {
     return;
   }
+  const text = getVoicePhrase(duration);
   try {
-    const text = getVoicePhrase(duration);
-    const psCommand = [
-      'Add-Type -AssemblyName System.Speech;',
-      '$s = New-Object System.Speech.Synthesis.SpeechSynthesizer;',
-      `$s.Speak("${text.replace(/"/g, '`"')}");`,
-    ].join('');
-    spawn('powershell', ['-Command', psCommand], {
-      stdio: 'ignore',
-      windowsHide: true,
-    });
-  } catch {
-    // silent fail
+    switch (PLATFORM) {
+      case 'win32': {
+        const psCommand = [
+          'Add-Type -AssemblyName System.Speech;',
+          '$s = New-Object System.Speech.Synthesis.SpeechSynthesizer;',
+          `$s.Speak("${text.replace(/"/g, '`"')}");`,
+        ].join('');
+        spawn('powershell', ['-Command', psCommand], {
+          stdio: 'ignore',
+          windowsHide: true,
+        });
+        break;
+      }
+      case 'darwin':
+        spawn('say', [text], { stdio: 'ignore' });
+        break;
+      case 'linux': {
+        const child = spawn('spd-say', [text], { stdio: 'ignore' });
+        child.on('error', () => {
+          spawn('espeak', [text], { stdio: 'ignore' });
+        });
+        break;
+      }
+    }
+  } catch (err) {
+    debugLog(config, 'speakResult failed:', err.message);
   }
 }
 
@@ -558,7 +626,7 @@ process.stdin.on('end', async () => {
   delete state._telegramText;
   saveState(state);
 
-  await sendWindowsNotification(config, message);
+  await sendDesktopNotification(config, message);
   playSound(config);
   speakResult(config, duration);
 });

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "claude-notification-plugin",
   "productName": "claude-notification-plugin",
-  "version": "1.0.47",
-  "description": "Claude Code notifications щт task completion: Telegram, Windows toast, sound, and voice",
+  "version": "1.0.50",
+  "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
   "type": "module",
   "engines": {
     "node": ">=18.0.0"
@@ -30,7 +30,10 @@
     "claude-code",
     "notifications",
     "telegram",
-    "hooks"
+    "hooks",
+    "macos",
+    "linux",
+    "cross-platform"
   ],
   "author": {
     "name": "Viacheslav Makarov",