Agent Notification

Beautiful Windows toast notifications for OpenCode and Claude Code.

Run one command, choose the agents you use, and the installer adds the local notification hooks for you.

• npm: @moudy99/agent-notification
• GitHub: moudy99/agent-notification

Install And Run

npx @moudy99/agent-notification

The CLI opens an interactive installer:

AGENT NOTIFICATION

Select agents to install notifications for:

[ ] OpenCode
[ ] Claude Code

Use:

SPACE  toggle
ENTER  install
CTRL+C cancel

You can select OpenCode, Claude Code, or both.

After selecting agents, enter how many seconds each notification should stay visible.

Direct Commands

Install both without the selector:

npx @moudy99/agent-notification --all

Install only OpenCode:

npx @moudy99/agent-notification --opencode

Install only Claude Code:

npx @moudy99/agent-notification --claude

Overwrite existing files without asking:

npx @moudy99/agent-notification --all --yes

Set the notification duration directly:

npx @moudy99/agent-notification --all --duration=10

What It Installs

OpenCode

~/.config/opencode/plugins/plan-complete-notify.js
~/.config/opencode/hooks/notification.ps1
~/.config/opencode/hooks/notification.bat
~/.config/opencode/hooks/notification.vbs
~/.config/opencode/hooks/notification-config.json

Notifications fire when:

• OpenCode completes a response.
• OpenCode asks a plan-mode question.
• OpenCode needs permission to continue.

Restart OpenCode after installing.

Claude Code

~/.claude/hooks/notification.ps1
~/.claude/hooks/notification.bat
~/.claude/hooks/notification-config.json
~/.claude/settings.json

The installer adds these hook events:

• Stop
• Notification

It does not add SubagentStop, so subagent completions do not trigger premature notifications.

Restart Claude Code after installing.

Safety

• Windows-only.
• Uses local PowerShell WPF toast windows.
• No runtime network calls.
• Writes only to your user config folders.
• Asks before overwriting existing hook files.
• Backs up ~/.claude/settings.json before editing.
• Removes old package-installed welcome.ps1 Claude hook entries to avoid duplicate notifications.
• Stores only the notification display duration in notification-config.json.