dsh-agent-sound-alert

During long agent sessions, the moments that matter most--a turn completing, a tool approval being requested, an abnormal stop--fly by in an instant. Step away from the screen and they are gone before the context shifts. dsh-agent-sound-alert bridges DeepSeek Harness session events to macOS system sounds: Glass for a clean turn end, Tink for approval requests (debounced per session), Basso for errors or blocked turns, and Sosumi for policy-hook interruptions. Each event carries a distinct tone, so a quick auditory cue tells you what just happened without scrolling through logs.

The plugin maps five event types to sounds out of the box, and every mapping is overridable with any macOS system sound name or an absolute path to a local audio file. Approval sounds include a configurable debounce interval (default 2500 ms) so rapid successive prompts do not stack into a wall of noise. All settings--master switch, volume, debounce, subagent inclusion, and individual sound choices--apply live from the plugin configuration panel with no restart required. Under the hood it makes zero network requests, collects no telemetry, and only reads local session lifecycle events before launching afplay. Concurrent playback is capped at three processes, and all active players stop cleanly when the plugin is unloaded.

If you are a macOS-focused DeepSeek Harness developer who regularly juggles multi-tool approvals, long generation turns, and subagent orchestration, this plugin adds an auditory channel to an already-visual workflow. The agent gets a one-note cue to say: your turn is done, come look.