claude-notification-plugin 1.0.96 → 1.0.99

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-notification-plugin",
-  "version": "1.0.96",
+  "version": "1.0.99",
   "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

@@ -484,6 +484,19 @@ Claude Notification Plugin - Setup
   addHook(settings, 'Stop');
   addHook(settings, 'Notification');
 
+  // Register plugin as enabled
+  settings.enabledPlugins = settings.enabledPlugins || {};
+  settings.enabledPlugins[PLUGIN_KEY] = true;
+
+  // Register marketplace
+  settings.extraKnownMarketplaces = settings.extraKnownMarketplaces || {};
+  settings.extraKnownMarketplaces[MARKETPLACE_KEY] = {
+    source: {
+      source: 'github',
+      repo: MARKETPLACE_GITHUB,
+    },
+  };
+
   fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
 
   // 5. Summary
@@ -513,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

@@ -12,6 +12,8 @@ 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';
 
 // Remove hooks from settings.json
 if (fs.existsSync(settingsPath)) {
@@ -34,6 +36,22 @@ if (fs.existsSync(settingsPath)) {
       }
     }
 
+    // Remove plugin from enabledPlugins
+    if (settings.enabledPlugins?.[PLUGIN_KEY]) {
+      delete settings.enabledPlugins[PLUGIN_KEY];
+      if (Object.keys(settings.enabledPlugins).length === 0) {
+        delete settings.enabledPlugins;
+      }
+    }
+
+    // Remove marketplace from extraKnownMarketplaces
+    if (settings.extraKnownMarketplaces?.[MARKETPLACE_KEY]) {
+      delete settings.extraKnownMarketplaces[MARKETPLACE_KEY];
+      if (Object.keys(settings.extraKnownMarketplaces).length === 0) {
+        delete settings.extraKnownMarketplaces;
+      }
+    }
+
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
   } catch {
     // ignore
@@ -80,7 +98,6 @@ for (const dir of wrapperDirs) {
 }
 
 // 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)) {

package/commit-sha

@@ -1 +1 @@
-dbbfbd026315df5250a8765f89adbd2e125e745e
+cea9eaeeae4658684c2f1977bdc09fa20916bf7c

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.96",
+  "version": "1.0.99",
   "description": "Claude Code task-completion notifications: Telegram, desktop notifications (Windows/macOS/Linux), sound, and voice",
   "type": "module",
   "engines": {