@mohak34/opencode-notifier 0.1.27-beta.1 → 0.1.27

package/README.md

@@ -55,6 +55,9 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "showSessionTitle": false,
   "showIcon": true,
   "notificationSystem": "osascript",
+  "linux": {
+    "grouping": false
+  },
   "command": {
     "enabled": false,
     "path": "/path/to/command",
@@ -115,6 +118,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
 - `showSessionTitle` - Include the session title in notification messages via `{sessionTitle}` placeholder (default: true)
 - `showIcon` - Show OpenCode icon, Windows/Linux only (default: true)
 - `notificationSystem` - macOS only: `"osascript"` or `"node-notifier"` (default: "osascript")
+- `linux.grouping` - Linux only: replace notifications in-place instead of stacking (default: false). Requires `notify-send` 0.8+
 
 ### Events
 
@@ -263,6 +267,24 @@ Run your own script when something happens. Use `{event}`, `{message}`, and `{se
 
 **NOTE:** If you go with node-notifier and start missing notifications, just switch back or remove the option from the config. Users have reported issues with using node-notifier for receiving only sounds and no notification popups.
 
+## Linux: Notification Grouping
+
+By default, each notification appears as a separate entry. During active sessions this can create noise when multiple events fire quickly (e.g. permission + complete + question).
+
+Enable grouping to replace notifications in-place instead of stacking:
+
+```json
+{
+  "linux": {
+    "grouping": true
+  }
+}
+```
+
+With grouping enabled, each new notification replaces the previous one so you only see the latest event. This requires `notify-send` 0.8+ (standard on Ubuntu 22.04+, Debian 12+, Fedora 36+, Arch). On older systems it falls back to the default stacking behavior automatically.
+
+Works with all major notification daemons (GNOME, dunst, mako, swaync, etc.) on both X11 and Wayland.
+
 ## Updating
 
 If Opencode does not update the plugin or there is an issue with the cache version:

package/dist/index.js

@@ -3746,6 +3746,9 @@ var DEFAULT_CONFIG = {
   showSessionTitle: false,
   showIcon: true,
   notificationSystem: "osascript",
+  linux: {
+    grouping: false
+  },
   command: {
     enabled: false,
     path: "",
@@ -3842,6 +3845,9 @@ function loadConfig() {
       showSessionTitle: userConfig.showSessionTitle ?? DEFAULT_CONFIG.showSessionTitle,
       showIcon: userConfig.showIcon ?? DEFAULT_CONFIG.showIcon,
       notificationSystem: userConfig.notificationSystem === "node-notifier" ? "node-notifier" : "osascript",
+      linux: {
+        grouping: typeof userConfig.linux?.grouping === "boolean" ? userConfig.linux.grouping : DEFAULT_CONFIG.linux.grouping
+      },
       command: {
         enabled: typeof userCommand.enabled === "boolean" ? userCommand.enabled : DEFAULT_CONFIG.command.enabled,
         path: typeof userCommand.path === "string" ? userCommand.path : DEFAULT_CONFIG.command.path,
@@ -3928,7 +3934,7 @@ function interpolateMessage(message, context) {
 // src/notify.ts
 var import_node_notifier = __toESM(require_node_notifier(), 1);
 import os from "os";
-import { exec } from "child_process";
+import { exec, execFile } from "child_process";
 var DEBOUNCE_MS = 1000;
 var platform = os.type();
 var platformNotifier;
@@ -3942,7 +3948,53 @@ if (platform === "Linux" || platform.match(/BSD$/)) {
   platformNotifier = import_node_notifier.default;
 }
 var lastNotificationTime = {};
-async function sendNotification(title, message, timeout, iconPath, notificationSystem = "osascript") {
+var lastLinuxNotificationId = null;
+var linuxNotifySendSupportsReplace = null;
+function detectNotifySendCapabilities() {
+  return new Promise((resolve) => {
+    execFile("notify-send", ["--version"], (error, stdout) => {
+      if (error) {
+        resolve(false);
+        return;
+      }
+      const match = stdout.match(/(\d+)\.(\d+)/);
+      if (match) {
+        const major = parseInt(match[1], 10);
+        const minor = parseInt(match[2], 10);
+        resolve(major > 0 || major === 0 && minor >= 8);
+        return;
+      }
+      resolve(false);
+    });
+  });
+}
+function sendLinuxNotificationDirect(title, message, timeout, iconPath, grouping = true) {
+  return new Promise((resolve) => {
+    const args = [];
+    if (iconPath) {
+      args.push("--icon", iconPath);
+    }
+    args.push("--expire-time", String(timeout * 1000));
+    args.push("--app-name", "OpenCode");
+    if (grouping && lastLinuxNotificationId !== null) {
+      args.push("--replace-id", String(lastLinuxNotificationId));
+    }
+    if (grouping) {
+      args.push("--print-id");
+    }
+    args.push("--", title, message);
+    execFile("notify-send", args, (error, stdout) => {
+      if (!error && grouping && stdout) {
+        const id = parseInt(stdout.trim(), 10);
+        if (!isNaN(id)) {
+          lastLinuxNotificationId = id;
+        }
+      }
+      resolve();
+    });
+  });
+}
+async function sendNotification(title, message, timeout, iconPath, notificationSystem = "osascript", linuxGrouping = true) {
   const now = Date.now();
   if (lastNotificationTime[message] && now - lastNotificationTime[message] < DEBOUNCE_MS) {
     return;
@@ -3970,6 +4022,16 @@ async function sendNotification(title, message, timeout, iconPath, notificationS
       });
     });
   }
+  if (platform === "Linux" || platform.match(/BSD$/)) {
+    if (linuxGrouping) {
+      if (linuxNotifySendSupportsReplace === null) {
+        linuxNotifySendSupportsReplace = await detectNotifySendCapabilities();
+      }
+      if (linuxNotifySendSupportsReplace) {
+        return sendLinuxNotificationDirect(title, message, timeout, iconPath, true);
+      }
+    }
+  }
   return new Promise((resolve) => {
     const notificationOptions = {
       title,
@@ -4169,7 +4231,7 @@ async function handleEvent(config, eventType, projectName, elapsedSeconds, sessi
   if (isEventNotificationEnabled(config, eventType)) {
     const title = getNotificationTitle(config, projectName);
     const iconPath = getIconPath(config);
-    promises.push(sendNotification(title, message, config.timeout, iconPath, config.notificationSystem));
+    promises.push(sendNotification(title, message, config.timeout, iconPath, config.notificationSystem, config.linux.grouping));
   }
   if (isEventSoundEnabled(config, eventType)) {
     const customSoundPath = getSoundPath(config, eventType);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mohak34/opencode-notifier",
-  "version": "0.1.27-beta.1",
+  "version": "0.1.27",
   "description": "OpenCode plugin that sends system notifications and plays sounds when permission is needed, generation completes, or errors occur",
   "author": "mohak34",
   "license": "MIT",