dsh-notify

You fire off a long DSH session in the background and switch to other work — only to come back and find the agent has already asked three questions, or an approval is still sitting unattended. dsh-notify is built for exactly this: it sits on the DSH session event stream as a pure observer (never intercepting or mutating session behavior) and pings you at four key moments: turn complete, goal complete, agent asks a question, and an action needs approval.

The smart part is presence detection. The browser half reports the current tab and window-focus state in real time, so you get no buzz while you are already looking at the session, but the moment you tab away, minimize, or switch apps, a desktop notification appears with the system default sound. All four triggers are independently toggleable, and the notification backend supports notify-send, a custom shell command, or plain console output — failures are logged silently and never affect the session.

Ideal for developers who routinely run long agent tasks in the background while context-switching. On Linux desktops it works out of the box; in headless or TUI setups there is no browser to report presence, so every trigger point fires a notification.