@mohak34/opencode-notifier 0.1.32 → 0.1.34-beta

package/README.md

@@ -55,6 +55,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "showSessionTitle": false,
   "showIcon": true,
   "suppressWhenFocused": true,
+  "enableOnDesktop": false,
   "notificationSystem": "osascript",
   "linux": {
     "grouping": false
@@ -66,12 +67,12 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
     "minDuration": 0
   },
   "events": {
-    "permission": { "sound": true, "notification": true },
-    "complete": { "sound": true, "notification": true },
-    "subagent_complete": { "sound": false, "notification": false },
-    "error": { "sound": true, "notification": true },
-    "question": { "sound": true, "notification": true },
-    "user_cancelled": { "sound": false, "notification": false }
+    "permission": { "sound": true, "notification": true, "command": true },
+    "complete": { "sound": true, "notification": true, "command": true },
+    "subagent_complete": { "sound": false, "notification": false, "command": true },
+    "error": { "sound": true, "notification": true, "command": true },
+    "question": { "sound": true, "notification": true, "command": true },
+    "user_cancelled": { "sound": false, "notification": false, "command": true }
   },
   "messages": {
     "permission": "Session needs permission: {sessionTitle}",
@@ -112,6 +113,8 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "showProjectName": true,
   "showSessionTitle": false,
   "showIcon": true,
+  "suppressWhenFocused": true,
+  "enableOnDesktop": false,
   "notificationSystem": "osascript"
 }
 ```
@@ -123,7 +126,8 @@ 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)
 - `suppressWhenFocused` - Skip notifications and sounds when the terminal is the active window (default: true). See [Focus detection](#focus-detection) for platform details
-- `notificationSystem` - macOS only: `"osascript"`, `"node-notifier"`, or `"ghostty"` (default: "osascript"). Use `"ghostty"` if you're running Ghostty terminal for native OSC 777 notifications
+- `enableOnDesktop` - Run the plugin on Desktop and Web clients (default: false). When false, the plugin only runs on CLI. Set to true if you want notifications/sounds/commands on Desktop/Web — useful if you want custom commands (Telegram, webhooks) but don't care about built-in notifications
+- `notificationSystem` - macOS only: `"osascript"`, `"node-notifier"`, or `"ghostty"` (default: "osascript"). Use `"ghostty"` if you're running Ghostty terminal for native OSC 9 notifications
 - `linux.grouping` - Linux only: replace notifications in-place instead of stacking (default: false). Requires `notify-send` 0.8+
 
 ### Events
@@ -133,18 +137,20 @@ Control each event separately:
 ```json
 {
   "events": {
-    "permission": { "sound": true, "notification": true },
-    "complete": { "sound": true, "notification": true },
-    "subagent_complete": { "sound": false, "notification": false },
-    "error": { "sound": true, "notification": true },
-    "question": { "sound": true, "notification": true },
-    "user_cancelled": { "sound": false, "notification": false }
+    "permission": { "sound": true, "notification": true, "command": true },
+    "complete": { "sound": true, "notification": true, "command": true },
+    "subagent_complete": { "sound": false, "notification": false, "command": true },
+    "error": { "sound": true, "notification": true, "command": true },
+    "question": { "sound": true, "notification": true, "command": true },
+    "user_cancelled": { "sound": false, "notification": false, "command": true }
   }
 }
 ```
 
 `user_cancelled` fires when you press ESC to abort a session. It's silent by default so intentional cancellations don't trigger error alerts. Set `sound` or `notification` to `true` if you want confirmation when cancelling.
 
+The `command` property controls whether the custom command (see [Custom commands](#custom-commands)) runs for that event. Defaults to `true` for all events. Set it to `false` to suppress the command for specific events without disabling it globally.
+
 Or use true/false for both:
 
 ```json

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/index.ts
 import { basename } from "path";
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { readFileSync as readFileSync2, writeFileSync } from "fs";
 
 // src/config.ts
 import { readFileSync, existsSync } from "fs";
@@ -9,7 +9,8 @@ import { homedir } from "os";
 import { fileURLToPath } from "url";
 var DEFAULT_EVENT_CONFIG = {
   sound: true,
-  notification: true
+  notification: true,
+  command: true
 };
 var DEFAULT_CONFIG = {
   sound: true,
@@ -19,6 +20,7 @@ var DEFAULT_CONFIG = {
   showSessionTitle: false,
   showIcon: true,
   suppressWhenFocused: true,
+  enableOnDesktop: false,
   notificationSystem: "osascript",
   linux: {
     grouping: false
@@ -31,11 +33,11 @@ var DEFAULT_CONFIG = {
   events: {
     permission: { ...DEFAULT_EVENT_CONFIG },
     complete: { ...DEFAULT_EVENT_CONFIG },
-    subagent_complete: { sound: false, notification: false },
+    subagent_complete: { ...DEFAULT_EVENT_CONFIG, sound: false, notification: false },
     error: { ...DEFAULT_EVENT_CONFIG },
     question: { ...DEFAULT_EVENT_CONFIG },
     interrupted: { ...DEFAULT_EVENT_CONFIG },
-    user_cancelled: { sound: false, notification: false }
+    user_cancelled: { ...DEFAULT_EVENT_CONFIG, sound: false, notification: false }
   },
   messages: {
     permission: "Session needs permission: {sessionTitle}",
@@ -82,12 +84,14 @@ function parseEventConfig(userEvent, defaultConfig) {
   if (typeof userEvent === "boolean") {
     return {
       sound: userEvent,
-      notification: userEvent
+      notification: userEvent,
+      command: userEvent
     };
   }
   return {
     sound: userEvent.sound ?? defaultConfig.sound,
-    notification: userEvent.notification ?? defaultConfig.notification
+    notification: userEvent.notification ?? defaultConfig.notification,
+    command: userEvent.command ?? defaultConfig.command
   };
 }
 function parseVolume(value, defaultVolume) {
@@ -114,7 +118,8 @@ function loadConfig() {
     const globalNotification = userConfig.notification ?? DEFAULT_CONFIG.notification;
     const defaultWithGlobal = {
       sound: globalSound,
-      notification: globalNotification
+      notification: globalNotification,
+      command: true
     };
     const userCommand = userConfig.command ?? {};
     const commandArgs = Array.isArray(userCommand.args) ? userCommand.args.filter((arg) => typeof arg === "string") : undefined;
@@ -127,6 +132,7 @@ function loadConfig() {
       showSessionTitle: userConfig.showSessionTitle ?? DEFAULT_CONFIG.showSessionTitle,
       showIcon: userConfig.showIcon ?? DEFAULT_CONFIG.showIcon,
       suppressWhenFocused: userConfig.suppressWhenFocused ?? DEFAULT_CONFIG.suppressWhenFocused,
+      enableOnDesktop: typeof userConfig.enableOnDesktop === "boolean" ? userConfig.enableOnDesktop : DEFAULT_CONFIG.enableOnDesktop,
       notificationSystem: userConfig.notificationSystem === "node-notifier" ? "node-notifier" : userConfig.notificationSystem === "ghostty" ? "ghostty" : "osascript",
       linux: {
         grouping: typeof userConfig.linux?.grouping === "boolean" ? userConfig.linux.grouping : DEFAULT_CONFIG.linux.grouping
@@ -140,11 +146,11 @@ function loadConfig() {
       events: {
         permission: parseEventConfig(userConfig.events?.permission ?? userConfig.permission, defaultWithGlobal),
         complete: parseEventConfig(userConfig.events?.complete ?? userConfig.complete, defaultWithGlobal),
-        subagent_complete: parseEventConfig(userConfig.events?.subagent_complete ?? userConfig.subagent_complete, { sound: false, notification: false }),
+        subagent_complete: parseEventConfig(userConfig.events?.subagent_complete ?? userConfig.subagent_complete, { sound: false, notification: false, command: true }),
         error: parseEventConfig(userConfig.events?.error ?? userConfig.error, defaultWithGlobal),
         question: parseEventConfig(userConfig.events?.question ?? userConfig.question, defaultWithGlobal),
         interrupted: parseEventConfig(userConfig.events?.interrupted ?? userConfig.interrupted, defaultWithGlobal),
-        user_cancelled: parseEventConfig(userConfig.events?.user_cancelled ?? userConfig.user_cancelled, { sound: false, notification: false })
+        user_cancelled: parseEventConfig(userConfig.events?.user_cancelled ?? userConfig.user_cancelled, { sound: false, notification: false, command: true })
       },
       messages: {
         permission: userConfig.messages?.permission ?? DEFAULT_CONFIG.messages.permission,
@@ -184,6 +190,9 @@ function isEventSoundEnabled(config, event) {
 function isEventNotificationEnabled(config, event) {
   return config.events[event].notification;
 }
+function isEventCommandEnabled(config, event) {
+  return config.events[event].command;
+}
 function getMessage(config, event) {
   return config.messages[event];
 }
@@ -262,6 +271,7 @@ function detectNotifySendCapabilities() {
 function sendLinuxNotificationDirect(title, message, timeout, iconPath, grouping = true) {
   return new Promise((resolve) => {
     const args = [];
+    args.push("--app-name", "opencode");
     if (iconPath) {
       args.push("--icon", iconPath);
     }
@@ -336,7 +346,8 @@ async function sendNotification(title, message, timeout, iconPath, notificationS
       title,
       message,
       timeout,
-      icon: iconPath
+      icon: iconPath,
+      "app-name": "opencode"
     };
     platformNotifier.notify(notificationOptions, () => {
       resolve();
@@ -420,7 +431,7 @@ async function playOnLinux(soundPath, volume) {
   const players = [
     { command: "paplay", args: [`--volume=${pulseVolume}`, soundPath] },
     { command: "aplay", args: [soundPath] },
-    { command: "mpv", args: ["--no-video", "--no-terminal", `--volume=${percentVolume}`, soundPath] },
+    { command: "mpv", args: ["--no-video", "--no-terminal", "--script-opts=autoload-disabled=yes", `--volume=${percentVolume}`, soundPath] },
     { command: "ffplay", args: ["-nodisp", "-autoexit", "-loglevel", "quiet", "-volume", `${percentVolume}`, soundPath] }
   ];
   for (const player of players) {
@@ -493,7 +504,7 @@ function runCommand2(config, event, message, sessionTitle, projectName, timestam
 }
 
 // src/focus.ts
-import { execSync } from "child_process";
+import { execFileSync, execSync } from "child_process";
 function execWithTimeout(command, timeoutMs = 500) {
   try {
     return execSync(command, { timeout: timeoutMs, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
@@ -501,6 +512,13 @@ function execWithTimeout(command, timeoutMs = 500) {
     return null;
   }
 }
+function execFileWithTimeout(command, args, timeoutMs = 500) {
+  try {
+    return execFileSync(command, args, { timeout: timeoutMs, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+  } catch {
+    return null;
+  }
+}
 function getHyprlandActiveWindowId() {
   const output = execWithTimeout("hyprctl activewindow -j");
   if (!output)
@@ -554,18 +572,11 @@ function getLinuxWaylandActiveWindowId() {
   return null;
 }
 function getWindowsActiveWindowId() {
-  const script = `
-Add-Type @"
-using System;
-using System.Runtime.InteropServices;
-public class FocusHelper {
-  [DllImport("user32.dll")] public static extern IntPtr GetForegroundWindow();
-}
-"@
-$hwnd = [FocusHelper]::GetForegroundWindow()
-Write-Output $hwnd
-`.trim().replace(/\n/g, "; ");
-  return execWithTimeout(`powershell -NoProfile -Command "${script}"`, 1000);
+  const script = `$type=Add-Type -Name FocusHelper -Namespace OpenCodeNotifier -MemberDefinition '[DllImport("user32.dll")] public static extern IntPtr GetForegroundWindow();' -PassThru; $type::GetForegroundWindow()`;
+  let windowId = execFileWithTimeout("powershell", ["-NoProfile", "-NonInteractive", "-Command", script], 1000);
+  if (!windowId)
+    windowId = execFileWithTimeout("pwsh", ["-NoProfile", "-NonInteractive", "-Command", script], 1000);
+  return windowId;
 }
 function getMacOSActiveWindowId() {
   return execWithTimeout(`osascript -e 'tell application "System Events" to return id of window 1 of (first application process whose frontmost is true)'`);
@@ -630,7 +641,7 @@ function loadTurnCount() {
 }
 function saveTurnCount(count) {
   try {
-    writeFileSync2(getStatePath(), JSON.stringify({ turn: count }));
+    writeFileSync(getStatePath(), JSON.stringify({ turn: count }));
   } catch {}
 }
 function incrementTurnCount() {
@@ -697,7 +708,7 @@ async function handleEvent(config, eventType, projectName, elapsedSeconds, sessi
     promises.push(playSound(eventType, customSoundPath, soundVolume));
   }
   const minDuration = config.command?.minDuration;
-  const shouldSkipCommand = typeof minDuration === "number" && Number.isFinite(minDuration) && minDuration > 0 && typeof elapsedSeconds === "number" && Number.isFinite(elapsedSeconds) && elapsedSeconds < minDuration;
+  const shouldSkipCommand = !isEventCommandEnabled(config, eventType) || typeof minDuration === "number" && Number.isFinite(minDuration) && minDuration > 0 && typeof elapsedSeconds === "number" && Number.isFinite(elapsedSeconds) && elapsedSeconds < minDuration;
   if (!shouldSkipCommand) {
     runCommand2(config, eventType, message, sessionTitle, projectName, timestamp, turn);
   }
@@ -838,7 +849,9 @@ async function handleEventWithElapsedTime(client, config, eventType, projectName
 var NotifierPlugin = async ({ client, directory }) => {
   const clientEnv = process.env.OPENCODE_CLIENT;
   if (clientEnv && clientEnv !== "cli") {
-    return {};
+    const config = loadConfig();
+    if (!config.enableOnDesktop)
+      return {};
   }
   const getConfig = () => loadConfig();
   const projectName = directory ? basename(directory) : null;

package/package.json

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