claude-notification-plugin 1.0.52 → 1.0.59

package/.claude-plugin/plugin.json

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

package/README.md

@@ -81,6 +81,8 @@ Config file: `~/.claude/notifier.config.json`
   "voice": {
     "enabled": true
   },
+  "webhookUrl": "",
+  "sendUserPromptToWebhook": false,
   "minSeconds": 15,
   "notifyOnWaiting": false,
   "debug": false
@@ -97,23 +99,29 @@ Each channel has an `enabled` flag (`true`/`false`) for global control.
 
 `notifyOnWaiting` — send notifications when Claude is waiting for user input, e.g. permission prompts (default: `false`, set `true` to enable).
 
+`webhookUrl` — URL to send a POST request with full notification data (JSON). If empty, no request is sent. On `Stop`/`Notification` events the payload includes `title`, `project`, `branch`, `duration`, `trigger`, `voicePhrase`, and `hookEvent` (the raw hook input). Useful for integrating with custom dashboards, logging services, or automation pipelines.
+
+`sendUserPromptToWebhook` — also send user prompts to the webhook URL (default: `false`). When enabled, each `UserPromptSubmit` event sends a POST with `title`, `project`, `trigger`, `prompt` (user's message text), and `hookEvent`. Requires `webhookUrl` to be set.
+
 `debug` — include extra info in notifications: voice phrase text, full hook event JSON (formatted as code block in Telegram). Default: `false`.
 
-Environment variables `TELEGRAM_TOKEN` and `TELEGRAM_CHAT_ID` override config file values.
+Environment variables `CLAUDE_NOTIFY_TELEGRAM_TOKEN` and `CLAUDE_NOTIFY_TELEGRAM_CHAT_ID` override config file values.
 
 ### Per-channel environment variables
 
 These env vars override the global config per channel (`"1"` = on, `"0"` = off):
 
-| Variable                 | Channel                    |
-|--------------------------|----------------------------|
-| `CLAUDE_NOTIFY_TELEGRAM` | Telegram messages          |
-| `CLAUDE_NOTIFY_DESKTOP`  | Desktop notifications      |
-| `CLAUDE_NOTIFY_SOUND`    | Sound alert                |
-| `CLAUDE_NOTIFY_VOICE`    | Voice announcement (TTS)   |
-| `CLAUDE_NOTIFY_WAITING`  | Waiting-for-input events   |
-| `CLAUDE_NOTIFY_DEBUG`    | Debug mode                 |
-| `CLAUDE_NOTIFY_INCLUDE_LAST_CC_MESSAGE_IN_TELEGRAM` | Include last Claude message in Telegram |
+| Variable                                              | Channel                                 |
+|-------------------------------------------------------|-----------------------------------------|
+| `CLAUDE_NOTIFY_TELEGRAM`                              | Telegram messages                       |
+| `CLAUDE_NOTIFY_DESKTOP`                               | Desktop notifications                   |
+| `CLAUDE_NOTIFY_SOUND`                                 | Sound alert                             |
+| `CLAUDE_NOTIFY_VOICE`                                 | Voice announcement (TTS)                |
+| `CLAUDE_NOTIFY_WAITING`                               | Waiting-for-input events                |
+| `CLAUDE_NOTIFY_DEBUG`                                 | Debug mode                              |
+| `CLAUDE_NOTIFY_INCLUDE_LAST_CC_MESSAGE_IN_TELEGRAM`   | Include last Claude message in Telegram |
+| `CLAUDE_NOTIFY_WEBHOOK_URL`                           | Webhook URL for POST requests           |
+| `CLAUDE_NOTIFY_SEND_USER_PROMPT_TO_WEBHOOK`           | Send user prompts to webhook            |
 
 ### Per-project configuration
 
@@ -122,14 +130,16 @@ Add to `.claude/settings.local.json` in the project root to control channels per
 ```json
 {
   "env": {
-    "DISABLE_CLAUDE_NOTIFIER": 0,
+    "CLAUDE_NOTIFY_DISABLE": 0,
     "CLAUDE_NOTIFY_TELEGRAM": 1,
     "CLAUDE_NOTIFY_DESKTOP": 1,
     "CLAUDE_NOTIFY_SOUND": 1,
     "CLAUDE_NOTIFY_VOICE": 1,
     "CLAUDE_NOTIFY_WAITING": 1,
     "CLAUDE_NOTIFY_DEBUG": 0,
-    "CLAUDE_NOTIFY_INCLUDE_LAST_CC_MESSAGE_IN_TELEGRAM": 1
+    "CLAUDE_NOTIFY_INCLUDE_LAST_CC_MESSAGE_IN_TELEGRAM": 1,
+    "CLAUDE_NOTIFY_WEBHOOK_URL": "",
+    "CLAUDE_NOTIFY_SEND_USER_PROMPT_TO_WEBHOOK": 0
   }
 }
 ```
@@ -139,19 +149,20 @@ To disable all notifications for a project:
 ```json
 {
   "env": {
-    "DISABLE_CLAUDE_NOTIFIER": "1"
+    "CLAUDE_NOTIFY_DISABLE": "1"
   }
 }
 ```
 
 ## Notification format
 
-Notifications include project name, duration, and the trigger event:
+Notifications include project name, git branch (when available), duration, and the trigger event:
 
 ```
 🤖 Claude finished coding
 
 Project: my-project
+Branch: feature-auth
 Duration: 45s
 Trigger: Stop
 ```
@@ -162,6 +173,7 @@ When Claude is waiting for input (and `notifyOnWaiting` is enabled):
 🤖 Claude waiting for input
 
 Project: my-project
+Branch: feature-auth
 Duration: 30s
 Trigger: Notification
 ```

package/bin/install.js

@@ -161,6 +161,8 @@ async function main () {
     voice: {
       enabled: true,
     },
+    webhookUrl: '',
+    sendUserPromptToWebhook: false,
     minSeconds: 15,
     notifyOnWaiting: false,
     debug: false,
@@ -235,7 +237,7 @@ async function main () {
 
   console.log('');
   console.log('To disable per project, add to .claude/settings.local.json:');
-  console.log('  { "env": { "DISABLE_CLAUDE_NOTIFIER": "1" } }');
+  console.log('  { "env": { "CLAUDE_NOTIFY_DISABLE": "1" } }');
   console.log('');
 }
 

package/notifier/notifier.js

@@ -4,7 +4,7 @@ import fs from 'fs';
 import os from 'os';
 import path from 'path';
 import process from 'process';
-import { spawn } from 'child_process';
+import { execSync, spawn } from 'child_process';
 
 // ----------------------
 // CONFIG
@@ -26,6 +26,19 @@ function debugLog (config, ...args) {
   }
 }
 
+function getBranch (cwd) {
+  try {
+    return execSync('git rev-parse --abbrev-ref HEAD', {
+      cwd,
+      encoding: 'utf-8',
+      windowsHide: true,
+      timeout: 3000,
+    }).trim();
+  } catch {
+    return '';
+  }
+}
+
 function loadConfig () {
   const configPath = path.join(os.homedir(), '.claude', 'notifier.config.json');
 
@@ -47,6 +60,8 @@ function loadConfig () {
     voice: {
       enabled: true,
     },
+    webhookUrl: '',
+    sendUserPromptToWebhook: false,
     minSeconds: 15,
     notifyOnWaiting: false,
     debug: false,
@@ -77,16 +92,22 @@ function loadConfig () {
       if (typeof user.debug === 'boolean') {
         config.debug = user.debug;
       }
+      if (typeof user.webhookUrl === 'string') {
+        config.webhookUrl = user.webhookUrl;
+      }
+      if (typeof user.sendUserPromptToWebhook === 'boolean') {
+        config.sendUserPromptToWebhook = user.sendUserPromptToWebhook;
+      }
     } catch {
       // ignore malformed config
     }
   }
 
-  if (process.env.TELEGRAM_TOKEN) {
-    config.telegram.token = process.env.TELEGRAM_TOKEN;
+  if (process.env.CLAUDE_NOTIFY_TELEGRAM_TOKEN) {
+    config.telegram.token = process.env.CLAUDE_NOTIFY_TELEGRAM_TOKEN;
   }
-  if (process.env.TELEGRAM_CHAT_ID) {
-    config.telegram.chatId = process.env.TELEGRAM_CHAT_ID;
+  if (process.env.CLAUDE_NOTIFY_TELEGRAM_CHAT_ID) {
+    config.telegram.chatId = process.env.CLAUDE_NOTIFY_TELEGRAM_CHAT_ID;
   }
 
   // Per-channel env overrides (0 = off, 1 = on)
@@ -111,6 +132,12 @@ function loadConfig () {
   if (process.env.CLAUDE_NOTIFY_INCLUDE_LAST_CC_MESSAGE_IN_TELEGRAM !== undefined) {
     config.telegram.includeLastCcMessageInTelegram = process.env.CLAUDE_NOTIFY_INCLUDE_LAST_CC_MESSAGE_IN_TELEGRAM === '1';
   }
+  if (process.env.CLAUDE_NOTIFY_WEBHOOK_URL) {
+    config.webhookUrl = process.env.CLAUDE_NOTIFY_WEBHOOK_URL;
+  }
+  if (process.env.CLAUDE_NOTIFY_SEND_USER_PROMPT_TO_WEBHOOK !== undefined) {
+    config.sendUserPromptToWebhook = process.env.CLAUDE_NOTIFY_SEND_USER_PROMPT_TO_WEBHOOK === '1';
+  }
 
   return config;
 }
@@ -120,8 +147,8 @@ function loadConfig () {
 // ----------------------
 
 function isNotifierDisabled () {
-  return process.env.DISABLE_CLAUDE_NOTIFIER === '1'
-    || process.env.DISABLE_CLAUDE_NOTIFIER === 'true';
+  return process.env.CLAUDE_NOTIFY_DISABLE === '1'
+    || process.env.CLAUDE_NOTIFY_DISABLE === 'true';
 }
 
 // ----------------------
@@ -137,12 +164,23 @@ const STATE_FILE = path.join(
 function loadState () {
   if (fs.existsSync(STATE_FILE)) {
     try {
-      return JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
+      const raw = JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
+      // Migrate flat state (pre-session format) to new format
+      if (!raw.sessions && raw.start !== undefined) {
+        return { sessions: {}, sentMessages: raw.sentMessages || [] };
+      }
+      if (!raw.sessions) {
+        raw.sessions = {};
+      }
+      if (!raw.sentMessages) {
+        raw.sentMessages = [];
+      }
+      return raw;
     } catch {
-      return {};
+      return { sessions: {}, sentMessages: [] };
     }
   }
-  return {};
+  return { sessions: {}, sentMessages: [] };
 }
 
 function saveState (state) {
@@ -151,6 +189,16 @@ function saveState (state) {
   fs.writeFileSync(STATE_FILE, JSON.stringify(state));
 }
 
+function cleanStaleSessions (state) {
+  const maxAge = 24 * 3600_000;
+  const now = Date.now();
+  for (const sid of Object.keys(state.sessions)) {
+    if (now - state.sessions[sid].start > maxAge) {
+      delete state.sessions[sid];
+    }
+  }
+}
+
 // ----------------------
 // TELEGRAM
 // ----------------------
@@ -286,6 +334,25 @@ async function sendTelegram (config, state) {
   }
 }
 
+// ----------------------
+// WEBHOOK
+// ----------------------
+
+async function sendWebhook (config, payload) {
+  if (!config.webhookUrl) {
+    return;
+  }
+  try {
+    await fetch(config.webhookUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(payload),
+    });
+  } catch (err) {
+    debugLog(config, 'sendWebhook failed:', err.message);
+  }
+}
+
 // ----------------------
 // DESKTOP NOTIFICATION
 // ----------------------
@@ -553,20 +620,31 @@ process.stdin.on('end', async () => {
   const eventType = event.hook_event_name || 'unknown';
   const cwd = event.cwd || process.cwd();
   const project = path.basename(cwd);
+  const sessionId = event.session_id || 'default';
 
   if (isNotifierDisabled()) {
     process.exit(0);
   }
 
   const state = loadState();
+  cleanStaleSessions(state);
 
   // ----------------------
   // START TIMER
   // ----------------------
 
   if (eventType === 'UserPromptSubmit') {
-    state.start = Date.now();
+    state.sessions[sessionId] = { start: Date.now() };
     saveState(state);
+    if (config.sendUserPromptToWebhook) {
+      await sendWebhook(config, {
+        title: 'User prompt submitted',
+        project,
+        trigger: eventType,
+        prompt: event.prompt || '',
+        hookEvent: event,
+      });
+    }
     process.exit(0);
   }
 
@@ -583,8 +661,9 @@ process.stdin.on('end', async () => {
   }
 
   let duration = 0;
-  if (state.start) {
-    duration = Math.round((Date.now() - state.start) / 1000);
+  const session = state.sessions[sessionId];
+  if (session?.start) {
+    duration = Math.round((Date.now() - session.start) / 1000);
   }
 
   if (duration < config.minSeconds) {
@@ -595,11 +674,15 @@ process.stdin.on('end', async () => {
     ? 'Claude waiting for input'
     : 'Claude finished coding';
 
+  const branch = getBranch(cwd);
+  const branchLine = branch ? `\nBranch: ${branch}` : '';
+  const branchLineHtml = branch ? `\nBranch: <b>${escapeHtml(branch)}</b>` : '';
+
   let message =
-    `${title}\n\nProject: ${project}\nDuration: ${duration}s\nTrigger: ${eventType}`;
+    `${title}\n\nProject: ${project}${branchLine}\nDuration: ${duration}s\nTrigger: ${eventType}`;
 
   let telegramMessage =
-    `${escapeHtml(title)}\n\nProject: <b>${escapeHtml(project)}</b>\nDuration: ${duration}s\nTrigger: ${eventType}`;
+    `${escapeHtml(title)}\n\nProject: <b>${escapeHtml(project)}</b>${branchLineHtml}\nDuration: ${duration}s\nTrigger: ${eventType}`;
 
   if (config.telegram.includeLastCcMessageInTelegram && event.last_assistant_message) {
     const maxLen = 3500;
@@ -621,9 +704,22 @@ process.stdin.on('end', async () => {
     telegramMessage += debugBlockHtml;
   }
 
+  await sendWebhook(config, {
+    title,
+    project,
+    branch: branch || undefined,
+    duration,
+    trigger: eventType,
+    voicePhrase: config.voice.enabled ? getVoicePhrase(duration) : null,
+    hookEvent: event,
+  });
+
   state._telegramText = `\u{1F916} ${telegramMessage}`;
   await sendTelegram(config, state);
   delete state._telegramText;
+  if (eventType === 'Stop') {
+    delete state.sessions[sessionId];
+  }
   saveState(state);
 
   await sendDesktopNotification(config, message);

package/package.json

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