dsh-completion-sound

Running a ten-minute agent task is one thing; running a two-hour one while you are at lunch is another. The default DSH completion cue is a faint single beep that sounds the same whether the turn took four seconds or three hours, and nothing appears on the desktop to catch your eye. dsh-completion-sound splits that moment into two clearly distinct signals.

For every ordinary turn it synthesises a short two-tone chime (E5 into A5) with WebAudio, crisp and low-key. When a task exceeds the configurable threshold (default 10 minutes, adjustable from 1 minute up to 7 days), a special music track plays together with a full-screen modal that stops on any click. The bundled default is the roughly 13.5 MB Guan Yu Song, but the settings field accepts a single audio file path or a directory path; in directory mode a random track is picked on each play. Optional desktop notifications are delivered through the browser Notification API first, with an automatic fallback to osascript on macOS or notify-send on Linux. Every knob, from volume to music path, lives under a dedicated Settings > Completion sound page, so nothing hides behind an advanced menu.

It is built for people who fire off long agent runs, walk away, and want an unambiguous audible, visual, and system-level confirmation that the work is done.