dsh-desktop-notify

An agent task in DSH can take anywhere from a few dozen seconds to several minutes. You switch to another window, minimize the browser, and come back to find the agent finished a while ago—or worse, it is waiting for your reply with no way to reach you. dsh-desktop-notify plugs into that gap: a lightweight Windows Toast that nudges you exactly when DSH needs your attention.

The plugin fires on six key events—task completion, a pending question awaiting your reply, an approval silently denied under the never policy, a background subagent finishing, a goal completing or blocking, and a background command job ending. Every notification carries the workspace and session name, so multi-workspace sessions stay properly scoped. Under the hood a resident Python process (desktop-notifier + WinRT) handles delivery; notifications are sent line-by-line over stdin for single-digit-millisecond dispatch with no cold-start penalty. Toasts and the notification-center identity icon both use DSH's own transparent-background logo rather than the default Python snake.

The smartest part is focus-aware silencing: while the DSH tab is your active window the plugin stays quiet; the moment you switch away, minimize, or close the browser, alerts resume. Focus detection relies entirely on native visibilitychange, focus, and blur events—no polling, no delay. Built for Windows users who run DSH in a walk-away-and-come-back mode, especially those leveraging background subagents, multi-workspace sessions, or the never approval policy.