@landienzla/claude-code-notify 1.0.4 → 1.1.2

package/README.md

@@ -1,17 +1,23 @@
 # claude-code-notify
 
+[![CI](https://github.com/Landienzla/claude-code-notify/actions/workflows/ci.yml/badge.svg)](https://github.com/Landienzla/claude-code-notify/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@landienzla/claude-code-notify)](https://www.npmjs.com/package/@landienzla/claude-code-notify)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 Cross-platform desktop notifications for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Get notified when Claude Code needs your attention — permission approval, task completion, idle prompts, and more.
 
 Works as a **Claude Code plugin** (zero config) or as a **CLI setup tool**.
 
 ## Platforms
 
-| Platform | Method | Sound |
-|----------|--------|-------|
-| Windows | Toast notification (slides in from right) | Silent |
-| macOS | Native notification center | Default |
-| Linux | `notify-send` (libnotify) | Default |
-| WSL | Windows toast via PowerShell | Silent |
+| Platform | Method |
+|----------|--------|
+| Windows | Toast notification (slides in from right) |
+| macOS | Native notification center |
+| Linux | `notify-send` (libnotify) |
+| WSL | Windows toast via PowerShell |
+
+Notifications are **silent by default**. Use `--sound` to enable sound. Use `--name` to give your Claude a name.
 
 ## Quick Start
 
@@ -53,12 +59,16 @@ Plugin mode requires no changes to your `settings.json` — the hook is loaded a
 
 | Command | Description |
 |---------|-------------|
-| `claude-code-notify setup` | Install notification hook into `~/.claude/` |
+| `claude-code-notify setup` | Install notification hook (silent) |
+| `claude-code-notify setup --sound` | Install with sound enabled |
+| `claude-code-notify setup --name "Jarvis"` | Install with a custom name |
 | `claude-code-notify dry-run` | Preview what setup will change (no writes) |
 | `claude-code-notify test` | Send a test notification |
 | `claude-code-notify uninstall` | Remove notification hook and script |
 | `claude-code-notify help` | Show usage info |
 
+Options can be combined: `claude-code-notify setup --sound --name "Jarvis"`
+
 Run `dry-run` first to see exactly what files will be created/modified before committing.
 
 ## How It Works
@@ -81,7 +91,7 @@ The hook fires on all notification types:
 
 ## Requirements
 
-- **Python 3** — used for JSON parsing (available by default on macOS/Linux)
+- **Node.js** — already installed if you're using npm
 - **Linux:** `libnotify-bin` for `notify-send`
   ```bash
   # Debian/Ubuntu
@@ -119,9 +129,6 @@ npx @landienzla/claude-code-notify uninstall
 - Install `libnotify-bin` (see Requirements)
 - Ensure a notification daemon is running (e.g. `dunst`, `mako`, GNOME/KDE built-in)
 
-**Generic "Needs your attention" message instead of context:**
-- Ensure Python 3 is installed and on your PATH
-
 ## License
 
 [MIT](LICENSE)

package/bin/cli.js

@@ -13,20 +13,30 @@ const NOTIFY_DEST = path.join(SCRIPTS_DIR, 'notify.sh');
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
 const NOTIFY_SRC = path.join(PACKAGE_ROOT, 'hooks', 'scripts', 'notify.sh');
 
-const HOOK_CONFIG = {
-  Notification: [
-    {
-      matcher: '',
-      hooks: [
-        {
-          type: 'command',
-          command: `bash "${NOTIFY_DEST.replace(/\\/g, '/')}"`,
-          timeout: 10
-        }
-      ]
-    }
-  ]
-};
+// Parse flags
+const args = process.argv.slice(3);
+const sound = args.includes('--sound');
+const nameIdx = args.indexOf('--name');
+const name = nameIdx !== -1 && args[nameIdx + 1] ? args[nameIdx + 1] : null;
+const soundFlag = sound ? ' --sound' : '';
+const nameFlag = name ? ` --name "${name}"` : '';
+
+function hookConfig() {
+  return {
+    Notification: [
+      {
+        matcher: '',
+        hooks: [
+          {
+            type: 'command',
+            command: `bash "${NOTIFY_DEST.replace(/\\/g, '/')}"${soundFlag}${nameFlag}`,
+            timeout: 10
+          }
+        ]
+      }
+    ]
+  };
+}
 
 function dryRun() {
   console.log('Dry run — no changes will be made.\n');
@@ -36,7 +46,7 @@ function dryRun() {
   console.log(`  2. Add Notification hook to:`);
   console.log(`     ${SETTINGS_PATH}\n`);
   console.log('     Hook config:');
-  console.log(JSON.stringify(HOOK_CONFIG, null, 2).split('\n').map(l => '     ' + l).join('\n'));
+  console.log(JSON.stringify(hookConfig(), null, 2).split('\n').map(l => '     ' + l).join('\n'));
 
   if (fs.existsSync(SETTINGS_PATH)) {
     try {
@@ -49,16 +59,6 @@ function dryRun() {
     }
   }
 
-  // Check python3
-  const { spawnSync } = require('child_process');
-  const py = spawnSync('python3', ['--version'], { stdio: 'pipe' });
-  if (py.status !== 0) {
-    console.log('\n  Warning: Python 3 not found. Notifications will work but show');
-    console.log('  generic messages instead of contextual ones.');
-  } else {
-    console.log(`\n  Python 3: ${py.stdout.toString().trim()}`);
-  }
-
   console.log('\nRun "claude-code-notify setup" to apply these changes.');
 }
 
@@ -68,15 +68,6 @@ function setup() {
     process.exit(1);
   }
 
-  // Check python3 availability
-  const { spawnSync } = require('child_process');
-  const py = spawnSync('python3', ['--version'], { stdio: 'pipe' });
-  if (py.status !== 0) {
-    console.log('  Warning: Python 3 not found. Notifications will work but show');
-    console.log('  generic messages instead of contextual ones.');
-    console.log('  Install Python 3 for full functionality.\n');
-  }
-
   // Copy notify.sh
   fs.mkdirSync(SCRIPTS_DIR, { recursive: true });
   fs.copyFileSync(NOTIFY_SRC, NOTIFY_DEST);
@@ -101,11 +92,12 @@ function setup() {
   }
 
   if (!settings.hooks) settings.hooks = {};
-  settings.hooks.Notification = HOOK_CONFIG.Notification;
+  settings.hooks.Notification = hookConfig().Notification;
 
   fs.writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n');
   console.log(`  Updated ${SETTINGS_PATH}`);
 
+  if (name) console.log(`  Notifications will appear as "${name}".`);
   console.log('\nDone! Restart Claude Code for notifications to take effect.');
 }
 
@@ -138,7 +130,10 @@ function test() {
   const input = JSON.stringify({ notification_message: 'Test notification from claude-code-notify' });
   try {
     const { spawnSync } = require('child_process');
-    const result = spawnSync('bash', [NOTIFY_SRC], {
+    const scriptArgs = [NOTIFY_SRC];
+    if (sound) scriptArgs.push('--sound');
+    if (name) scriptArgs.push('--name', name);
+    const result = spawnSync('bash', scriptArgs, {
       input,
       stdio: ['pipe', 'inherit', 'inherit'],
       timeout: 15000
@@ -156,11 +151,15 @@ function help() {
 claude-code-notify - Desktop notifications for Claude Code
 
 Usage:
-  claude-code-notify setup       Install notification hook into ~/.claude/
-  claude-code-notify dry-run     Preview what setup will change (no writes)
-  claude-code-notify uninstall   Remove notification hook from ~/.claude/
-  claude-code-notify test        Send a test notification
-  claude-code-notify help        Show this help
+  claude-code-notify setup [options]    Install notification hook into ~/.claude/
+  claude-code-notify dry-run [options]  Preview what setup will change (no writes)
+  claude-code-notify uninstall          Remove notification hook from ~/.claude/
+  claude-code-notify test [options]     Send a test notification
+  claude-code-notify help               Show this help
+
+Options:
+  --sound          Enable notification sound (default: silent)
+  --name <name>    Give your Claude a name (e.g. --name "Jarvis")
 
 Plugin mode (no setup needed):
   claude --plugin-dir /path/to/node_modules/claude-code-notify

package/hooks/scripts/notify.sh

@@ -2,23 +2,41 @@
 # Cross-platform desktop notification for Claude Code
 # Reads hook JSON from stdin, extracts notification message, sends native OS notification
 
+# Parse flags
+SILENT=true
+NAME="Claude Code"
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --sound)  SILENT=false ;;
+    --silent) SILENT=true ;;
+    --name)   shift; NAME="$1" ;;
+  esac
+  shift
+done
+
 INPUT=$(cat)
 
 # Parse JSON and sanitize for safe shell usage
 # - Strip characters that could break shell/PowerShell/XML/AppleScript interpolation
 # - Truncate to 200 chars (OS notification display limit)
-MESSAGE=$(printf '%s' "$INPUT" | python3 -c "
-import sys, json, re
-data = json.load(sys.stdin)
-message = data.get('notification_message', data.get('message', 'Needs your attention'))
-message = re.sub(r'[^\w\s.,!?:;()\[\]{}/\\@#%+=\-]', '', message)
-message = message[:200]
-print(message)
+MESSAGE=$(printf '%s' "$INPUT" | node -e "
+let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{
+  try{const o=JSON.parse(d);
+    let m=o.notification_message||o.message||'Needs your attention';
+    m=m.replace(/[^\w\s.,!?:;()\[\]{}\/\\@#%+=\-]/g,'').slice(0,200);
+    process.stdout.write(m);
+  }catch(e){process.stdout.write('Needs your attention')}
+});
 " 2>/dev/null)
 
-# Fallback if python3 parsing fails
 MESSAGE="${MESSAGE:-Needs your attention}"
 
+# Build audio XML for Windows toast
+AUDIO_XML=""
+if [ "$SILENT" = true ]; then
+  AUDIO_XML='<audio silent="true"/>'
+fi
+
 # Detect OS and send notification
 case "$(uname -s)" in
   Linux*)
@@ -28,18 +46,26 @@ case "$(uname -s)" in
 [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] > \$null
 [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime] > \$null
 \$xml = New-Object Windows.Data.Xml.Dom.XmlDocument
-\$xml.LoadXml('<toast><visual><binding template=\"ToastText01\"><text id=\"1\">$MESSAGE</text></binding></visual><audio silent=\"true\"/></toast>')
+\$xml.LoadXml('<toast><visual><binding template=\"ToastText01\"><text id=\"1\">$MESSAGE</text></binding></visual>$AUDIO_XML</toast>')
 \$toast = New-Object Windows.UI.Notifications.ToastNotification \$xml
-[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('Claude Code').Show(\$toast)
+[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('$NAME').Show(\$toast)
 " 2>/dev/null
     else
       # Native Linux
-      notify-send "Claude Code" "$MESSAGE" --app-name="Claude Code" 2>/dev/null || true
+      if [ "$SILENT" = true ]; then
+        notify-send "$NAME" "$MESSAGE" --app-name="$NAME" -h string:suppress-sound:true 2>/dev/null || true
+      else
+        notify-send "$NAME" "$MESSAGE" --app-name="$NAME" 2>/dev/null || true
+      fi
     fi
     ;;
   Darwin*)
     # macOS
-    osascript -e "display notification \"$MESSAGE\" with title \"Claude Code\"" 2>/dev/null || true
+    if [ "$SILENT" = true ]; then
+      osascript -e "display notification \"$MESSAGE\" with title \"$NAME\"" 2>/dev/null || true
+    else
+      osascript -e "display notification \"$MESSAGE\" with title \"$NAME\" sound name \"default\"" 2>/dev/null || true
+    fi
     ;;
   CYGWIN*|MINGW*|MSYS*)
     # Native Windows (Git Bash / MSYS2)
@@ -47,9 +73,9 @@ case "$(uname -s)" in
 [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] > \$null
 [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType = WindowsRuntime] > \$null
 \$xml = New-Object Windows.Data.Xml.Dom.XmlDocument
-\$xml.LoadXml('<toast><visual><binding template=\"ToastText01\"><text id=\"1\">$MESSAGE</text></binding></visual><audio silent=\"true\"/></toast>')
+\$xml.LoadXml('<toast><visual><binding template=\"ToastText01\"><text id=\"1\">$MESSAGE</text></binding></visual>$AUDIO_XML</toast>')
 \$toast = New-Object Windows.UI.Notifications.ToastNotification \$xml
-[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('Claude Code').Show(\$toast)
+[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('$NAME').Show(\$toast)
 " 2>/dev/null
     ;;
 esac

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "@landienzla/claude-code-notify",
-  "version": "1.0.4",
+  "version": "1.1.2",
   "description": "Cross-platform desktop notifications for Claude Code — plugin and CLI setup tool",
   "author": "Talha <landienzla@gmail.com>",
+  "scripts": {
+    "test": "node --test test/cli.test.js test/notify.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",