Pasumao/dsh-plugin-notify

The only native Windows notification plugin with a system tray in the dsh ecosystem: when the agent stops running (finished / stopped / errored / hit output limit / waiting for you / session closed), it pops a native Windows Toast labeled with workspace + session, and a whale tray icon stays resident — glance at the tray while a long task runs. Anti-spam: rootsOnly (default) notifies root sessions only so subagents don't spam; cooldownMs (default 10000ms) enforces a minimum interval between two notifications of the same type in the same session. Zero runtime dependencies, zero build — one dsh plugin add command and it works.

Messaging & Communication ★ 2 updated 2026-08-29 ✅ runtime-tested
View on GitHub ↗

Install

dsh plugin --profile web add dsh-notify

dsh plugin --profile web add dsh-notify (npm 0.1.6 registry-verified 2026-08-29) or dsh plugin --profile web add github:Pasumao/dsh-plugin-notify. Restart dsh web after install — a whale tray icon appears. Zero runtime dependencies, zero build steps. English README: README.en.md. Windows 10/11 only, Node ≥ 22.5, tested on DSH 0.1.1-rc.2.

Compatibility

Windows 10/11 · Node ≥ 22.5 · tested on DSH 0.1.1-rc.2. Native Windows Toast + system tray; rootsOnly defaults to root-session-only notifications.

Details

Recent updates

Windows native Toast on agent stop states; system tray whale icon; rootsOnly + cooldownMs anti-spam; zero runtime deps.

FAQ

Which platforms are supported?
Windows 10/11 only (native Toast API), Node ≥ 22.5, tested on DSH 0.1.1-rc.2.
Will subagents spam me?
No — rootsOnly is on by default (root sessions only); set it to false only if you want subagent notifications.
I'm not getting notifications — why?
Check Windows Settings → System → Notifications allows PowerShell toasts, and that you're not in Focus Assist / Do Not Disturb.

Alternatives

omdsh-dev/dsh-web-ui-notify · MuziIsabel/dsh-win-notify · bill9109/dsh-web-ui-notify

More plugins in Messaging & Communication

Browse more in Messaging & Communication

Guides for Messaging & Communication plugins