OpenCode Notif Plugin

Desktop notifications and sound alerts for OpenCode.

Features

• Desktop notifications and sound alerts
• Configurable per-event (generation completed, permission requested, question asked, errors)
• Optional primaryOnly sound gating globally or per-event for subagent-heavy workflows
• Cooldown system to prevent spam
• Cross-platform (macOS, Linux)

Installation

git clone https://github.com/trethore/opencode-notif.git
cd opencode-notif
npm install
npm run deploy

Configuration

Default template: ./notif.jsonc

Installed config file: ~/.config/opencode/plugins/notif.jsonc

{
  "enabled": true,
  "showDesktopNotification": true,
  "soundAlert": true,
  "primaryOnly": false,
  "volume": 0.8,
  "cooldown": 30,
}

See docs/configuration.md for all options.

Built-in audio lives under assets/notif/sounds/, and deploy only updates assets/notif/.

Platform Requirements

Platform	Notifications	Audio
macOS	Built-in	Built-in
Linux	libnotify-bin	ffmpeg

See docs/platform-requirements.md for details.

License

MIT