@landienzla/claude-code-notify 1.0.3 → 1.0.5

package/README.md

@@ -54,10 +54,13 @@ 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 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 |
 
+Run `dry-run` first to see exactly what files will be created/modified before committing.
+
 ## How It Works
 
 Claude Code fires a [`Notification`](https://docs.anthropic.com/en/docs/claude-code/hooks) hook whenever it needs your attention. This package provides a handler that:
@@ -78,7 +81,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
@@ -116,9 +119,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

@@ -28,6 +28,30 @@ const HOOK_CONFIG = {
   ]
 };
 
+function dryRun() {
+  console.log('Dry run — no changes will be made.\n');
+  console.log('The following changes would be applied:\n');
+  console.log(`  1. Copy notification script to:`);
+  console.log(`     ${NOTIFY_DEST}\n`);
+  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'));
+
+  if (fs.existsSync(SETTINGS_PATH)) {
+    try {
+      const settings = JSON.parse(fs.readFileSync(SETTINGS_PATH, 'utf8'));
+      if (settings.hooks && settings.hooks.Notification) {
+        console.log('\n  Warning: Existing Notification hook will be replaced.');
+      }
+    } catch (e) {
+      console.log(`\n  Warning: ${SETTINGS_PATH} is invalid JSON and will be backed up.`);
+    }
+  }
+
+  console.log('\nRun "claude-code-notify setup" to apply these changes.');
+}
+
 function setup() {
   if (!fs.existsSync(CLAUDE_DIR)) {
     console.error(`Error: ${CLAUDE_DIR} does not exist. Is Claude Code installed?`);
@@ -53,6 +77,10 @@ function setup() {
     }
   }
 
+  if (settings.hooks && settings.hooks.Notification) {
+    console.log('  Replacing existing Notification hook.');
+  }
+
   if (!settings.hooks) settings.hooks = {};
   settings.hooks.Notification = HOOK_CONFIG.Notification;
 
@@ -110,6 +138,7 @@ 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
@@ -123,6 +152,7 @@ const command = process.argv[2];
 
 switch (command) {
   case 'setup':    setup(); break;
+  case 'dry-run':  dryRun(); break;
   case 'uninstall': uninstall(); break;
   case 'test':     test(); break;
   case 'help': case '--help': case '-h': case undefined: help(); break;

package/hooks/scripts/notify.sh

@@ -7,13 +7,14 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@landienzla/claude-code-notify",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Cross-platform desktop notifications for Claude Code — plugin and CLI setup tool",
   "author": "Talha <landienzla@gmail.com>",
   "license": "MIT",