Notify Me

Sound and toast notifications for OpenCode. Know when the AI finishes, needs you, or hits an error — without staring at your terminal.

Why

You delegate a task and switch to another window. Now you're checking back every 30 seconds. Did it finish? Did it error? Is it waiting for permission?

This plugin solves that:

• Stay focused — Work in other apps. A sound + toast arrives when the AI needs you.
• Three states — Success (task done), Attention (input needed), Error (something broke).
• Cross-platform — Works on macOS, Linux, and Windows.
• Custom sounds — Use your own MP3s or fall back to system sounds.

Installation

npm i opencode-notify-me

Add to your OpenCode config:

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": ["opencode-notify-me"]
}

OpenCode auto-installs on startup. No manual steps needed.

Configuration

Create ~/.config/opencode/alert.json:

{
  "soundEnabled": true,
  "toastEnabled": true,
  "sounds": {
    "success": "~/.config/opencode/sounds/success.mp3",
    "attention": "~/.config/opencode/sounds/attention.mp3",
    "error": "~/.config/opencode/sounds/error.mp3"
  }
}

Or use env vars (take precedence):

• OPENCODE_ALERT_DISABLE_SOUND=1
• OPENCODE_ALERT_DISABLE_TOAST=1
• OPENCODE_ALERT_DISABLE_ALL=1

Platform Support

Feature	macOS	Linux	Windows
Custom MP3 sounds	Yes (afplay)	Yes (paplay/ffplay)	Yes (WMP COM / ffplay)
System sound fallback	Yes	Yes	Yes
Toast notifications	Yes (osascript)	Yes (notify-send)	Yes (PowerShell)

License

MIT © 2026 Lucas Malizia