@landienzla/claude-code-notify 1.0.5 → 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

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 {
@@ -82,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.');
 }
 
@@ -119,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
@@ -137,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,6 +2,18 @@
 # 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
@@ -17,9 +29,14 @@ let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{
 });
 " 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*)
@@ -29,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)
@@ -48,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.5",
+  "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",