dsh-done-notifier

Running multi-turn conversations in DeepSeek Harness, the model finishes and is waiting for your input, but you have just switched to another window or walked away. You come back and realize you wasted a few minutes staring at a cursor. dsh-done-notifier exists for exactly that moment: it turns the transition into an actionable macOS system notification banner and plays a real child-voice chime so you instantly know it is your turn.

Under the hood, the plugin listens to the host agent/status event and fires a single notification when the state moves from running back to idle, simultaneously playing a bundled mp3 via afplay. It uses ctx.agents.roots() to target only top-level conversations and filters out sub-agent completions automatically, so multi-agent pipelines do not trigger a barrage of alerts. Consecutive tool calls within one turn keep the state at running, preventing duplicate pop-ups. The whole implementation is pure JavaScript with zero external dependencies and no build step; install directly from GitHub and restart DSH to go live.

It is a good fit for macOS users who frequently run long conversations or multi-tool-call sessions in DSH and switch between chat, IDE, and browser. As long as your profile includes the agents and shell services from @deepseek-ai/dsh-base, the plugin will work out of the box. On non-macOS platforms it prints a brief warning and skips silently without affecting other DSH functionality. The banner text and chime file are both easily customizable.