@mohak34/opencode-notifier 0.2.6 → 0.2.7-beta.0

package/README.md

@@ -74,6 +74,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "suppressWhenFocused": true,
   "enableOnDesktop": false,
   "notificationSystem": "osascript",
+  "suppressGhosttySound": false,
   "linux": {
     "grouping": false
   },
@@ -151,7 +152,8 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
   "showIcon": true,
   "suppressWhenFocused": true,
   "enableOnDesktop": false,
-  "notificationSystem": "osascript"
+  "notificationSystem": "osascript",
+  "suppressGhosttySound": false
 }
 ```
 
@@ -167,6 +169,7 @@ Create `~/.config/opencode/opencode-notifier.json` with the defaults:
 - `suppressWhenFocused` - Skip notifications and sounds when the terminal is the active window (default: true). See [Focus detection](#focus-detection) for platform details
 - `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
+- `suppressGhosttySound` - macOS only: when `true` with `notificationSystem: "ghostty"`, skips the plugin's sound to avoid duplicating macOS Notification Center's default sound (default: false)
 - `minDuration` - Suppress `complete` and `subagent_complete` notifications when session finishes faster than this many seconds (default: 0). See [Minimum duration threshold](#minimum-duration-threshold)
 - `linux.grouping` - Linux only: replace notifications in-place instead of stacking (default: false). Requires `notify-send` 0.8+
 
@@ -363,6 +366,17 @@ If you're using [Ghostty](https://ghostty.org/) terminal, you can use its native
 
 This sends notifications directly through the terminal instead of using system notification tools. Works on any platform where Ghostty is running.
 
+**macOS:** Ghostty delivers notifications through macOS Notification Center, which plays its own default sound. This can result in duplicate audio with the plugin's sound effects. Set `suppressGhosttySound` to `true` to skip the plugin's sound:
+
+```json
+{
+  "notificationSystem": "ghostty",
+  "suppressGhosttySound": true
+}
+```
+
+Note: custom sounds configured via the `sounds` section still play — only default (bundled) sounds are suppressed.
+
 If you're using Ghostty inside tmux, enable passthrough in your tmux config so OSC 9 notifications can pass through:
 
 ```tmux

package/dist/index.js

@@ -101,6 +101,7 @@ var DEFAULT_CONFIG = {
   suppressWhenFocused: true,
   enableOnDesktop: false,
   notificationSystem: "osascript",
+  suppressGhosttySound: false,
   linux: {
     grouping: false
   },
@@ -237,6 +238,7 @@ function loadConfig() {
       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",
+      suppressGhosttySound: typeof userConfig.suppressGhosttySound === "boolean" ? userConfig.suppressGhosttySound : DEFAULT_CONFIG.suppressGhosttySound,
       linux: {
         grouping: typeof userConfig.linux?.grouping === "boolean" ? userConfig.linux.grouping : DEFAULT_CONFIG.linux.grouping
       },
@@ -1560,7 +1562,8 @@ async function handleEvent(config, eventType, projectName, elapsedSeconds, sessi
     timestamp,
     turn
   });
-  if (isEventNotificationEnabled(config, eventType)) {
+  const notificationEnabled = isEventNotificationEnabled(config, eventType);
+  if (notificationEnabled) {
     const title = getNotificationTitle(config, projectName);
     const iconPath = getIconPath(config);
     const onNotificationClick = isKDEJumpBackSupported() ? () => void focusTerminal() : undefined;
@@ -1568,8 +1571,11 @@ async function handleEvent(config, eventType, projectName, elapsedSeconds, sessi
   }
   if (isEventSoundEnabled(config, eventType)) {
     const customSoundPath = getSoundPath(config, eventType);
-    const soundVolume = getSoundVolume(config, eventType);
-    promises.push(playSound(eventType, customSoundPath, soundVolume));
+    const ghosttyOnMac = process.platform === "darwin" && config.notificationSystem === "ghostty" && notificationEnabled && config.suppressGhosttySound;
+    if (!ghosttyOnMac) {
+      const soundVolume = getSoundVolume(config, eventType);
+      promises.push(playSound(eventType, customSoundPath, soundVolume));
+    }
   }
   if (isEventBellEnabled(config, eventType)) {
     promises.push(ringBell());

package/package.json

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