claude-notification-plugin 1.0.88 → 1.0.92

package/.claude-plugin/plugin.json

@@ -1,13 +1,13 @@
-{
-  "name": "claude-notification-plugin",
-  "version": "1.0.88",
-  "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
-  "author": {
-    "name": "Viacheslav Makarov",
-    "email": "npmjs@bazilio.ru"
-  },
-  "homepage": "https://github.com/Bazilio-san/claude-notification-plugin#readme",
-  "repository": "https://github.com/Bazilio-san/claude-notification-plugin",
-  "license": "MIT",
-  "keywords": ["notification", "telegram", "windows", "sound", "voice", "hooks"]
-}
+{
+  "name": "claude-notification-plugin",
+  "version": "1.0.92",
+  "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
+  "author": {
+    "name": "Viacheslav Makarov",
+    "email": "npmjs@bazilio.ru"
+  },
+  "homepage": "https://github.com/Bazilio-san/claude-notification-plugin#readme",
+  "repository": "https://github.com/Bazilio-san/claude-notification-plugin",
+  "license": "MIT",
+  "keywords": ["notification", "telegram", "windows", "sound", "voice", "hooks"]
+}

package/README.md

@@ -25,7 +25,7 @@ npm install -g claude-notification-plugin
 ```
 
 The installer prompts for Telegram bot credentials and sets everything up.
-Re-run `claude-notify-install` anytime to reconfigure.
+Re-run `claude-notify install` anytime to reconfigure.
 
 ## Uninstall
 
@@ -186,7 +186,7 @@ The `"default"` alias receives messages without a `@project` prefix.
 ### 2. Start the listener
 
 ```bash
-claude-notify-listener start
+claude-notify listener start
 ```
 
 ### 3. Send tasks from Telegram
@@ -209,10 +209,10 @@ The bot replies with status and results:
 ### 4. Manage the daemon
 
 ```bash
-claude-notify-listener status         # Check if running
-claude-notify-listener stop           # Stop
-claude-notify-listener restart        # Restart
-claude-notify-listener logs           # View last 50 log lines
+claude-notify listener status         # Check if running
+claude-notify listener stop           # Stop
+claude-notify listener restart        # Restart
+claude-notify listener logs           # View last 50 log lines
 ```
 
 ### 5. Bot commands
@@ -266,10 +266,11 @@ Worktrees are auto-created when you use `@project/branch` syntax (controlled by
 
 ## CLI Commands
 
-| Command                  | Description                                                                   |
-|--------------------------|-------------------------------------------------------------------------------|
-| `claude-notify-install`  | Re-run to reinstall plugin registration, Telegram config, hooks, CLI wrappers |
-| `claude-notify-listener` | Manage the Telegram Listener daemon (start/stop/status/logs/restart)          |
+```
+claude-notify install              Reinstall plugin registration, Telegram config, hooks
+claude-notify listener <action>    Manage the Telegram Listener daemon
+                                   Actions: start, stop, status, logs, restart
+```
 
 ## License
 

package/bin/cli.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+import { fileURLToPath } from 'url';
+import path from 'path';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const command = process.argv[2];
+
+switch (command) {
+  case 'install':
+    await import(path.join(__dirname, 'install.js'));
+    break;
+  case 'uninstall':
+    await import(path.join(__dirname, 'uninstall.js'));
+    break;
+  case 'listener': {
+    // Shift argv so listener-cli.js sees subcommand as argv[2]
+    process.argv = [process.argv[0], process.argv[1], ...process.argv.slice(3)];
+    await import(path.join(__dirname, 'listener-cli.js'));
+    break;
+  }
+  default:
+    // Hook mode: Claude Code pipes JSON to stdin with no args
+    if (!process.stdin.isTTY) {
+      await import(path.join(__dirname, '..', 'notifier', 'notifier.js'));
+    } else {
+      console.log('Usage: claude-notify <command> [options]');
+      console.log('');
+      console.log('Commands:');
+      console.log('  install              Setup plugin registration, Telegram config, hooks');
+      console.log('  uninstall            Remove plugin, hooks, config, CLI wrappers');
+      console.log('  listener <action>    Manage the Telegram Listener daemon');
+      console.log('                       Actions: start, stop, status, logs, restart');
+      process.exit(command ? 1 : 0);
+    }
+}

package/bin/install.js

@@ -20,17 +20,14 @@ const knownMarketplacesPath = path.join(pluginsDir, 'known_marketplaces.json');
 const marketplacesDir = path.join(pluginsDir, 'marketplaces');
 const RESOLVER_PATH = path.join(claudeDir, 'claude-notify-resolve.js');
 
-const HOOK_COMMAND = 'claude-notifier';
+const HOOK_COMMAND = 'claude-notify';
 const MARKETPLACE_KEY = 'bazilio-plugins';
 const PLUGIN_KEY = 'claude-notification-plugin@bazilio-plugins';
 const MARKETPLACE_REPO = 'https://github.com/Bazilio-san/claude-plugins.git';
 const MARKETPLACE_GITHUB = 'Bazilio-san/claude-plugins';
 
-const CLI_BINS = {
-  'claude-notify-listener': 'bin/listener-cli.js',
-  'claude-notify-install': 'bin/install.js',
-  'claude-notify-uninstall': 'bin/uninstall.js',
-};
+const CLI_BIN_NAME = 'claude-notify';
+const CLI_BIN_TARGET = 'bin/cli.js';
 
 // ──────────────────────────────────────
 // Plugin registration
@@ -217,28 +214,19 @@ function registerCli () {
 
   const isWindows = process.platform === 'win32';
   const resolverNative = RESOLVER_PATH.replace(/\//g, path.sep);
-  const created = [];
-
-  for (const [name, relPath] of Object.entries(CLI_BINS)) {
-    if (isWindows) {
-      const cmdFile = path.join(binDir, `${name}.cmd`);
-      const content = `@echo off\r\nnode "${resolverNative}" ${relPath} %*\r\n`;
-      fs.writeFileSync(cmdFile, content);
-      created.push(cmdFile);
-    } else {
-      const shFile = path.join(binDir, name);
-      const content = `#!/bin/sh\nexec node "${RESOLVER_PATH}" "${relPath}" "$@"\n`;
-      fs.writeFileSync(shFile, content, { mode: 0o755 });
-      created.push(shFile);
-    }
-  }
+  let wrapperPath;
 
-  if (created.length > 0) {
-    console.log('  CLI commands registered:');
-    for (const f of created) {
-      console.log(`    ${f}`);
-    }
+  if (isWindows) {
+    wrapperPath = path.join(binDir, `${CLI_BIN_NAME}.cmd`);
+    const content = `@echo off\r\nnode "${resolverNative}" ${CLI_BIN_TARGET} %*\r\n`;
+    fs.writeFileSync(wrapperPath, content);
+  } else {
+    wrapperPath = path.join(binDir, CLI_BIN_NAME);
+    const content = `#!/bin/sh\nexec node "${RESOLVER_PATH}" "${CLI_BIN_TARGET}" "$@"\n`;
+    fs.writeFileSync(wrapperPath, content, { mode: 0o755 });
   }
+
+  console.log(`  CLI wrapper registered: ${wrapperPath}`);
 }
 
 // ──────────────────────────────────────

package/bin/listener-cli.js

@@ -44,7 +44,7 @@ switch (command) {
     setTimeout(() => startDaemon(), 1000);
     break;
   default:
-    console.log('Usage: claude-notify-listener <start|stop|status|logs|restart>');
+    console.log('Usage: claude-notify listener <start|stop|status|logs|restart>');
     console.log('');
     console.log('Commands:');
     console.log('  start    Start the listener daemon');
@@ -75,7 +75,7 @@ function startDaemon () {
   // Validate config
   if (!fs.existsSync(CONFIG_FILE)) {
     console.error(`Config not found: ${CONFIG_FILE}`);
-    console.error('Run claude-notify-install first, or create the config manually.');
+    console.error('Run claude-notify install first, or create the config manually.');
     process.exit(1);
   }
 

package/bin/uninstall.js

@@ -11,7 +11,7 @@ const configPath = path.join(claudeDir, 'notifier.config.json');
 const settingsPath = path.join(claudeDir, 'settings.json');
 const statePath = path.join(claudeDir, '.notifier_state.json');
 
-const HOOK_COMMAND = 'claude-notifier';
+const HOOK_COMMAND = 'claude-notify';
 
 // Remove hooks from settings.json
 if (fs.existsSync(settingsPath)) {
@@ -49,26 +49,54 @@ for (const file of [configPath, statePath, resolverPath]) {
 }
 
 // Remove CLI wrapper scripts
-const CLI_BINS = ['claude-notify-listener', 'claude-notify-install', 'claude-notify-uninstall'];
+// Current name + legacy names from previous versions
+const WRAPPER_NAMES = ['claude-notify', 'claude-notify-listener', 'claude-notify-install', 'claude-notify-uninstall'];
 let cliBinsRemoved = false;
+const ext = process.platform === 'win32' ? '.cmd' : '';
+
+// Collect directories to check for wrapper scripts
+const wrapperDirs = new Set();
+
+// Directory next to claude binary
 try {
   const cmd = process.platform === 'win32' ? 'where claude' : 'which claude';
   const claudeBin = execSync(cmd, { encoding: 'utf-8', windowsHide: true }).trim().split('\n')[0].trim();
-  const claudeBinDir = path.dirname(claudeBin);
-  const ext = process.platform === 'win32' ? '.cmd' : '';
+  wrapperDirs.add(path.dirname(claudeBin));
+} catch {
+  // claude not in PATH
+}
 
-  for (const name of CLI_BINS) {
-    const filePath = path.join(claudeBinDir, `${name}${ext}`);
+// ~/.local/bin (common on Linux/macOS, also used on Windows)
+wrapperDirs.add(path.join(home, '.local', 'bin'));
+
+for (const dir of wrapperDirs) {
+  for (const name of WRAPPER_NAMES) {
+    const filePath = path.join(dir, `${name}${ext}`);
     if (fs.existsSync(filePath)) {
       fs.unlinkSync(filePath);
       cliBinsRemoved = true;
     }
   }
-} catch {
-  // claude not in PATH — nothing to remove
 }
 
-// Remove plugin cache (old versions left by Claude Code)
+// Remove from installed_plugins.json
+const PLUGIN_KEY = 'claude-notification-plugin@bazilio-plugins';
+const installedPluginsPath = path.join(claudeDir, 'plugins', 'installed_plugins.json');
+let pluginEntryRemoved = false;
+if (fs.existsSync(installedPluginsPath)) {
+  try {
+    const data = JSON.parse(fs.readFileSync(installedPluginsPath, 'utf-8'));
+    if (data.plugins?.[PLUGIN_KEY]) {
+      delete data.plugins[PLUGIN_KEY];
+      fs.writeFileSync(installedPluginsPath, JSON.stringify(data, null, 2));
+      pluginEntryRemoved = true;
+    }
+  } catch {
+    // ignore
+  }
+}
+
+// Remove plugin cache
 const pluginCacheDir = path.join(claudeDir, 'plugins', 'cache', 'bazilio-plugins', 'claude-notification-plugin');
 let cacheRemoved = false;
 if (fs.existsSync(pluginCacheDir)) {
@@ -80,8 +108,8 @@ console.log('');
 console.log('Claude Notification Plugin uninstalled.');
 console.log('Hooks removed from settings.json');
 console.log('Config files deleted.');
-if (cacheRemoved) {
-  console.log('Plugin cache cleaned.');
+if (pluginEntryRemoved || cacheRemoved) {
+  console.log('Plugin registration cleaned.');
 }
 if (cliBinsRemoved) {
   console.log('CLI wrapper scripts removed.');

package/listener/LISTENER-DETAILED.md

@@ -87,7 +87,7 @@ The `offset` parameter in the request ensures each message is processed exactly
 
 ## Detached process: why the listener lives without a terminal
 
-When you run `claude-notify-listener start`, the following happens:
+When you run `claude-notify listener start`, the following happens:
 
 ```
 Your terminal
@@ -117,7 +117,7 @@ Your terminal
 `child.unref()` — allows `listener-cli.js` to exit without waiting for the child.
 
 Result: the listener runs as a background OS process. It is not tied to a terminal or to Claude Code — only to the operating system. It will only stop when:
-- The `claude-notify-listener stop` command is issued (or `/stop` in Telegram)
+- The `claude-notify listener stop` command is issued (or `/stop` in Telegram)
 - The computer is shut down or restarted
 - It crashes due to an error
 
@@ -856,7 +856,7 @@ exec(`claude -p "${userText}"`)
 ### Listener won't start
 
 ```bash
-claude-notify-listener status
+claude-notify listener status
 # → Status: not running
 ```
 
@@ -865,11 +865,11 @@ Check:
 1. Does the config exist? `cat ~/.claude/notifier.config.json`
 2. Are `telegram.token` and `telegram.chatId` present?
 3. Is there a `listener.projects` section?
-4. Logs: `claude-notify-listener logs`
+4. Logs: `claude-notify listener logs`
 
 ### Bot doesn't respond
 
-1. Is the listener running? `claude-notify-listener status`
+1. Is the listener running? `claude-notify listener status`
 2. Is the chatId correct? Messages from other chats are ignored (check the log: `WARN Ignored message from chat ...`)
 3. Is the bot added to the chat? Write `/help` to the bot — if there's no response, check the token
 
@@ -882,7 +882,7 @@ Check:
 Or restart the listener:
 
 ```bash
-claude-notify-listener restart
+claude-notify listener restart
 ```
 
 The watchdog will automatically clear stale tasks on the next startup.
@@ -925,7 +925,7 @@ Suppose you have two projects: an API server and a web application.
 ```
 === 10:00 — Startup ===
 
-You (terminal): claude-notify-listener start
+You (terminal): claude-notify listener start
               → Listener started (PID: 12345)
 
 === 10:01 — First task ===

package/package.json

@@ -1,60 +1,57 @@
-{
-  "name": "claude-notification-plugin",
-  "productName": "claude-notification-plugin",
-  "version": "1.0.88",
-  "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
-  "type": "module",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    ".claude-plugin/",
-    "bin/",
-    "hooks/",
-    "listener/",
-    "notifier/",
-    "README.md",
-    "LICENSE"
-  ],
-  "bin": {
-    "claude-notify-install": "bin/install.js",
-    "claude-notify-uninstall": "bin/uninstall.js",
-    "claude-notifier": "notifier/notifier.js",
-    "claude-notify-listener": "bin/listener-cli.js"
-  },
-  "scripts": {
-    "preuninstall": "node bin/uninstall.js",
-    "postinstall": "node bin/install.js",
-    "lint": "eslint .",
-    "lint:fix": "eslint --fix ."
-  },
-  "keywords": [
-    "claude",
-    "claude-code",
-    "notifications",
-    "telegram",
-    "hooks",
-    "macos",
-    "linux",
-    "cross-platform"
-  ],
-  "author": {
-    "name": "Viacheslav Makarov",
-    "email": "npmjs@bazilio.ru"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Bazilio-san/claude-notification-plugin.git"
-  },
-  "homepage": "https://github.com/Bazilio-san/claude-notification-plugin#readme",
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "node-notifier": "^10.0.1"
-  },
-  "devDependencies": {
-    "eslint-plugin-import": "^2.31.0"
-  }
-}
+{
+  "name": "claude-notification-plugin",
+  "productName": "claude-notification-plugin",
+  "version": "1.0.92",
+  "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
+  "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    ".claude-plugin/",
+    "bin/",
+    "hooks/",
+    "listener/",
+    "notifier/",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "claude-notify": "bin/cli.js"
+  },
+  "scripts": {
+    "preuninstall": "node bin/uninstall.js",
+    "postinstall": "node bin/install.js",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix ."
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "notifications",
+    "telegram",
+    "hooks",
+    "macos",
+    "linux",
+    "cross-platform"
+  ],
+  "author": {
+    "name": "Viacheslav Makarov",
+    "email": "npmjs@bazilio.ru"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Bazilio-san/claude-notification-plugin.git"
+  },
+  "homepage": "https://github.com/Bazilio-san/claude-notification-plugin#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "node-notifier": "^10.0.1"
+  },
+  "devDependencies": {
+    "eslint-plugin-import": "^2.31.0"
+  }
+}