claude-notification-plugin 1.0.98 → 1.0.101

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-notification-plugin",
-  "version": "1.0.98",
+  "version": "1.0.101",
   "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
   "author": {
     "name": "Viacheslav Makarov",

package/README.md

@@ -24,6 +24,23 @@ Sends alerts to Telegram and desktop (Windows, macOS, Linux) when Claude finishe
 npm install -g claude-notification-plugin
 ```
 
+
+## Telegram Setup
+
+If you plan to work with Telegram, you need to pre-register the bot and send a message to it
+
+1. Open Telegram, find **@BotFather**
+2. Send `/newbot`, follow prompts, pick a name
+3. Copy the bot token (format: `123456789:ABCdef...`)
+4. **Send any message to your new bot**
+
+
+## Setup
+
+```bash
+claude-notify install
+```
+
 The installer prompts for Telegram bot credentials and sets everything up.
 Re-run `claude-notify install` anytime to reconfigure.
 
@@ -151,24 +168,21 @@ Add to `.claude/settings.local.json` in the project root:
 }
 ```
 
-## Telegram Setup
-
-1. Open Telegram, find **@BotFather**
-2. Send `/newbot`, follow prompts, pick a name
-3. Copy the bot token (format: `123456789:ABCdef...`)
-4. **Send any message to your new bot**
-5. Open `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`
-6. Find `"chat":{"id":123456789}` in the response — that's your Chat ID
-
-Alternative: add **@userinfobot** to a chat and it will reply with the ID.
-
 ## Telegram Listener
 
 Background daemon that receives tasks from Telegram and executes them via `claude -p`. The result is sent back to Telegram.
 
 The Listener uses the same bot and `chatId` as notifications.
 
-### 1. Add a `listener` section to config
+### 1. Configure the listener
+
+Run the interactive setup wizard:
+
+```bash
+claude-notify listener setup
+```
+
+Alternatively, add a `listener` section to config manually:
 
 ```json
 {
@@ -212,9 +226,10 @@ The bot replies with status and results:
 
 ```bash
 claude-notify listener status         # Check if running
-claude-notify listener stop           # Stop
-claude-notify listener restart        # Restart
+claude-notify listener stop
+claude-notify listener restart
 claude-notify listener logs           # View last 50 log lines
+claude-notify listener setup          # Interactive listener configuration
 ```
 
 ### 5. Bot commands
@@ -264,14 +279,25 @@ Worktrees are auto-created when you use `@project/branch` syntax (controlled by
 /rmworktree @api feature/payments   ← remove
 ```
 
+
 [Detailed Guide](listener/LISTENER-DETAILED.md) — internals, architecture, troubleshooting, full session example.
 
+
+## Manual Telegram bot chatId retrieval:
+
+- Open `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`
+- Find `"chat":{"id":123456789}` in the response — that's your Chat ID
+
+Alternative: add **@userinfobot** to a chat and it will reply with the ID.
+
+
 ## CLI Commands
 
 ```
 claude-notify install              Reinstall plugin registration, Telegram config, hooks
+claude-notify uninstall            Remove plugin, hooks, config, CLI wrappers
 claude-notify listener <action>    Manage the Telegram Listener daemon
-                                   Actions: start, stop, status, logs, restart
+                                   Actions: start, stop, status, setup, logs, restart
 ```
 
 ## License

package/bin/cli.js

@@ -29,13 +29,13 @@ switch (command) {
     if (!process.stdin.isTTY) {
       await import(toImportUrl(path.join('..', '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');
+      console.log(`Usage: claude-notify <command> [options]
+
+Commands:
+  install              Setup plugin registration, Telegram config, hooks
+  uninstall            Remove plugin, hooks, config, CLI wrappers
+  listener <action>    Manage the Telegram Listener daemon
+                       Actions: start, stop, status, logs, restart`);
       process.exit(command ? 1 : 0);
     }
 }

package/bin/install.js

@@ -526,9 +526,7 @@ ${telegramStatus}${platformTip}
 
 To uninstall:  claude-notify uninstall
 
-To disable per project, add to .claude/settings.local.json:
-  { "env": { "CLAUDE_NOTIFY_DISABLE": "1" } }
-`);
+To disable per project, add to .claude/settings.local.json: { "env": { "CLAUDE_NOTIFY_DISABLE": "1" } }`);
 }
 
 main().then(() => 0);

package/bin/listener-cli.js

@@ -3,6 +3,7 @@
 import fs from 'fs';
 import os from 'os';
 import path from 'path';
+import readline from 'readline';
 import { spawn, execSync } from 'child_process';
 import { fileURLToPath } from 'url';
 
@@ -43,15 +44,19 @@ switch (command) {
     stopDaemon();
     setTimeout(() => startDaemon(), 1000);
     break;
+  case 'setup':
+    setupListener();
+    break;
   default:
-    console.log('Usage: claude-notify listener <start|stop|status|logs|restart>');
-    console.log('');
-    console.log('Commands:');
-    console.log('  start    Start the listener daemon');
-    console.log('  stop     Stop the listener daemon');
-    console.log('  status   Show daemon status');
-    console.log('  logs     Show recent log entries');
-    console.log('  restart  Restart the daemon');
+    console.log(`Usage: claude-notify listener <start|stop|status|setup|logs|restart>
+
+Commands:
+  start    Start the listener daemon
+  stop     Stop the listener daemon
+  status   Show daemon status
+  setup    Interactive listener configuration
+  logs     Show recent log entries
+  restart  Restart the daemon`);
     process.exit(command ? 1 : 0);
 }
 
@@ -132,9 +137,9 @@ function startDaemon () {
   fs.mkdirSync(path.dirname(PID_FILE), { recursive: true });
   fs.writeFileSync(PID_FILE, String(child.pid));
 
-  console.log(`Listener started (PID: ${child.pid})`);
-  console.log(`Log: ${logFile}`);
-  console.log(`Projects: ${Object.keys(config.listener.projects).join(', ')}`);
+  console.log(`Listener started (PID: ${child.pid})
+Log: ${logFile}
+Projects: ${Object.keys(config.listener.projects).join(', ')}`);
 }
 
 function stopDaemon () {
@@ -191,8 +196,8 @@ function showStatus () {
   }
 
   const logFile = getLogFile();
-  console.log(`Status: running (PID: ${pid})`);
-  console.log(`Log: ${logFile}`);
+  console.log(`Status: running (PID: ${pid})
+Log: ${logFile}`);
 
   // Show last few log lines
   try {
@@ -266,3 +271,75 @@ function isProcessAlive (pid) {
     return false;
   }
 }
+
+function ask (rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => resolve(answer.trim()));
+  });
+}
+
+async function setupListener () {
+  let config = {};
+  if (fs.existsSync(CONFIG_FILE)) {
+    try {
+      config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+    } catch {
+      // ignore
+    }
+  }
+
+  config.listener = config.listener || {};
+  const L = config.listener;
+  const home = os.homedir();
+
+  const defaults = {
+    worktreeBaseDir: L.worktreeBaseDir || path.join(home, '.claude', 'worktrees'),
+    taskTimeoutMinutes: L.taskTimeoutMinutes ?? 30,
+    maxQueuePerWorkDir: L.maxQueuePerWorkDir ?? 10,
+    maxTotalTasks: L.maxTotalTasks ?? 50,
+    logDir: L.logDir || '',
+    taskLogDir: L.taskLogDir || '',
+    projectPath: L.projects?.default?.path || '',
+  };
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  console.log(`
+Listener Setup
+==============
+Press Enter to keep current value shown in [brackets].
+`);
+
+  const worktreeBaseDir = await ask(rl, `Worktree base dir [${defaults.worktreeBaseDir}]: `) || defaults.worktreeBaseDir;
+  const taskTimeoutStr = await ask(rl, `Task timeout, minutes [${defaults.taskTimeoutMinutes}]: `) || String(defaults.taskTimeoutMinutes);
+  const maxQueueStr = await ask(rl, `Max queue per work dir [${defaults.maxQueuePerWorkDir}]: `) || String(defaults.maxQueuePerWorkDir);
+  const maxTotalStr = await ask(rl, `Max total tasks [${defaults.maxTotalTasks}]: `) || String(defaults.maxTotalTasks);
+  const logDir = await ask(rl, `Log dir [${defaults.logDir || '(default)'}]: `) || defaults.logDir;
+  const taskLogDir = await ask(rl, `Task log dir [${defaults.taskLogDir || '(default)'}]: `) || defaults.taskLogDir;
+  const projectPath = await ask(rl, `Default project path [${defaults.projectPath || '(none)'}]: `) || defaults.projectPath;
+
+  rl.close();
+
+  L.worktreeBaseDir = worktreeBaseDir;
+  L.taskTimeoutMinutes = parseInt(taskTimeoutStr, 10) || defaults.taskTimeoutMinutes;
+  L.maxQueuePerWorkDir = parseInt(maxQueueStr, 10) || defaults.maxQueuePerWorkDir;
+  L.maxTotalTasks = parseInt(maxTotalStr, 10) || defaults.maxTotalTasks;
+  L.logDir = logDir;
+  L.taskLogDir = taskLogDir;
+
+  if (projectPath) {
+    L.projects = L.projects || {};
+    L.projects.default = L.projects.default || {};
+    L.projects.default.path = projectPath;
+  }
+
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+
+  console.log(`
+Listener config saved to ${CONFIG_FILE}
+Run "claude-notify listener start" to apply.
+`);
+}

package/bin/uninstall.js

@@ -9,26 +9,48 @@ const home = os.homedir();
 const claudeDir = path.join(home, '.claude');
 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-notify';
-const PLUGIN_KEY = 'claude-notification-plugin@bazilio-plugins';
-const MARKETPLACE_KEY = 'bazilio-plugins';
+const statePath = path.join(claudeDir, '.notifier_state.json');
+
+const HOOK_COMMAND = 'claude-notify';
+const PLUGIN_KEY = 'claude-notification-plugin@bazilio-plugins';
+const MARKETPLACE_KEY = 'bazilio-plugins';
+
+function isPluginHookCommand (command) {
+  if (typeof command !== 'string') {
+    return false;
+  }
+
+  const normalized = command.trim().toLowerCase();
+  if (!normalized) {
+    return false;
+  }
+
+  return normalized === HOOK_COMMAND || normalized.startsWith(`${HOOK_COMMAND} `);
+}
 
 // Remove hooks from settings.json
-if (fs.existsSync(settingsPath)) {
-  try {
-    const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
-
-    if (settings.hooks) {
-      for (const event of Object.keys(settings.hooks)) {
-        settings.hooks[event] = settings.hooks[event].filter((matcher) =>
-          !matcher.hooks?.some((h) => h.command?.includes(HOOK_COMMAND)),
-        );
-
-        if (settings.hooks[event].length === 0) {
-          delete settings.hooks[event];
-        }
+let hooksRemoved = false;
+let hooksRemoveError = '';
+if (fs.existsSync(settingsPath)) {
+  try {
+    const settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+    let hadPluginHooks = false;
+
+    if (settings.hooks) {
+      for (const event of Object.keys(settings.hooks)) {
+        const eventHooks = Array.isArray(settings.hooks[event]) ? settings.hooks[event] : [];
+        const hadInEvent = eventHooks.some((matcher) =>
+          matcher.hooks?.some((h) => isPluginHookCommand(h.command)),
+        );
+        hadPluginHooks = hadPluginHooks || hadInEvent;
+
+        settings.hooks[event] = settings.hooks[event].filter((matcher) =>
+          !matcher.hooks?.some((h) => isPluginHookCommand(h.command)),
+        );
+
+        if (settings.hooks[event].length === 0) {
+          delete settings.hooks[event];
+        }
       }
 
       if (Object.keys(settings.hooks).length === 0) {
@@ -53,9 +75,22 @@ if (fs.existsSync(settingsPath)) {
     }
 
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-  } catch {
-    // ignore
-  }
+
+    // Verify hooks were actually removed
+    const verify = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+    const remainingPluginHooks = verify.hooks
+      ? Object.values(verify.hooks).some((matchers) =>
+        Array.isArray(matchers) &&
+        matchers.some((m) => m.hooks?.some((h) => isPluginHookCommand(h.command))),
+      )
+      : false;
+    hooksRemoved = hadPluginHooks && !remainingPluginHooks;
+    if (hadPluginHooks && remainingPluginHooks) {
+      hooksRemoveError = 'Hooks still present in settings.json after removal attempt';
+    }
+  } catch (err) {
+    hooksRemoveError = `Failed to update settings.json: ${err.message}`;
+  }
 }
 
 // Remove config, state, and resolver files
@@ -66,9 +101,8 @@ for (const file of [configPath, statePath, resolverPath]) {
   }
 }
 
-// Remove CLI wrapper scripts
-// Current name + legacy names from previous versions
-const WRAPPER_NAMES = ['claude-notify', 'claude-notify-listener', 'claude-notify-install', 'claude-notify-uninstall'];
+// Remove CLI wrapper script
+const WRAPPER_NAMES = ['claude-notify'];
 let cliBinsRemoved = false;
 const ext = process.platform === 'win32' ? '.cmd' : '';
 
@@ -121,6 +155,12 @@ if (fs.existsSync(pluginCacheDir)) {
   cacheRemoved = !fs.existsSync(pluginCacheDir);
 }
 
+const hooksStatus = hooksRemoved
+  ? 'Hooks removed from settings.json'
+  : hooksRemoveError
+    ? `Warning: ${hooksRemoveError}`
+    : 'No hooks found in settings.json';
+
 const extras = [
   pluginEntryRemoved || cacheRemoved ? 'Plugin registration cleaned.' : '',
   cliBinsRemoved ? 'CLI wrapper scripts removed.' : '',
@@ -132,13 +172,13 @@ if (cacheStillExists) {
 Warning: Could not fully remove plugin cache directory:
   ${pluginCacheDir}
 Please remove it manually.
-Hooks removed from settings.json
+${hooksStatus}
 Config files deleted.${extras ? `\n${extras}` : ''}
 `);
 } else {
   console.log(`
 Claude Notification Plugin uninstalled.
-Hooks removed from settings.json
+${hooksStatus}
 Config files deleted.${extras ? `\n${extras}` : ''}
 `);
 }

package/commit-sha

@@ -1 +1 @@
-08eb3ee86c3e4b66cda1fc65a13b40b12080ba32
+e766d03df0c9561a16f5f2e1dff3dc896c1ee862

package/listener/LISTENER-DETAILED.md

@@ -276,6 +276,26 @@ TaskRunner emit 'complete'/'error'/'timeout'
 
 ## Configuration
 
+### Interactive setup
+
+```bash
+claude-notify listener setup
+```
+
+Prompts for each listener setting interactively. Current values are shown in `[brackets]` — press Enter to keep them:
+
+- **Worktree base dir** — where auto-created worktrees are stored
+- **Task timeout, minutes** — max execution time per task
+- **Max queue per work dir** — queue limit per working directory
+- **Max total tasks** — global task limit across all queues
+- **Log dir** — listener operational log directory
+- **Task log dir** — task Q&A log directory
+- **Default project path** — path for the `default` project alias
+
+Re-run `claude-notify listener setup` anytime to reconfigure.
+
+### Manual configuration
+
 Full example of `~/.claude/notifier.config.json` with the listener section:
 
 ```json

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-notification-plugin",
   "productName": "claude-notification-plugin",
-  "version": "1.0.98",
+  "version": "1.0.101",
   "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
   "type": "module",
   "engines": {