opencode-simple-notify

Desktop notification plugin for OpenCode.

Sends native desktop notifications when:

• Session completes — shows project name, elapsed time, and your last message as preview
• Session errors — alerts when something goes wrong
• Permission requested — notifies when OpenCode needs approval
• Waiting for input — notifies when OpenCode asks you a question / presents choices

Platform Support

Platform	Method	Requirements
Linux (Wayland/X11)	dbus-send (freedesktop Notifications)	A notification daemon (dunst, mako, swaync, fnott, etc.)
macOS	osascript	None (built-in)

Install

From npm

Add to your opencode.json:

{
  "plugin": ["opencode-simple-notify"]
}

From local file

Copy index.js to your plugin directory:

# Global
cp index.js ~/.config/opencode/plugins/notify.js

# Project-level
cp index.js .opencode/plugins/notify.js

Notification Examples

┌─────────────────────────────────────┐
│  my-project done (2m35s)            │
│  帮我写一个排序函数                    │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│  OpenCode needs approval            │
│  Permission: bash                   │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│  OpenCode waiting                   │
│  选择发布方式                         │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│  my-project error                   │
│  session encountered an error       │
└─────────────────────────────────────┘

License

MIT