dsh-web-notification

You have probably been there: a DSH agent is grinding through a long task, you switch to another tab to check docs or answer an email, and when you come back it has either finished ages ago or is sitting on a permission request waiting for you. dsh-web-notification exists for exactly this gap. While the DSH page is hidden or unfocused, it fires a real browser system notification — a Notification Center banner on macOS, optionally with sound. Two events trigger it: the agent transitioning from running to idle (a turn has ended), and the harness raising an approval or permission ask (including tool name and reason). Clicking the notification refocuses the DSH window, and repeated notifications for the same session replace each other instead of stacking.

The plugin is deliberately minimal. It registers no model-facing tools, writes nothing to session logs, consumes zero tokens, and its approval listener is strictly pass-through — it cannot block, alter, or answer an approval. The host half is plain ESM JavaScript and the client half is a dependency-free single-file bundle; edit, reinstall, restart the web server, done. No build step at all. The README spells out the boundaries clearly: a denied site notification permission cannot be overridden from within the page, delivery latency is bounded by the 2-second poll interval, and notifications stop once the tab is closed.

Who is it for? If you juggle multiple apps and tabs while a DSH session runs in the background and you would rather not keep that window in front of you, this plugin fills the blind spot neatly. It is zero-invasive to the harness — no changes to approval policies or model configuration are needed. Install it, grant notification permission once, restart the web server, and you are set.