dsh-ui-notify
Completion sound notifications for the DeepSeek Harness web GUI. When a session's output finishes, the plugin plays an embedded chime; the Notifications row in Settings → General turns it on or off, picks a sound (with preview), sets the volume, and chooses whether to ring for background sessions only or every session.
Settings persist in browser localStorage. The plugin is a pure web plugin — it registers no host service, no tool, and no session-log entry.
Install
The package is published to the npm registry. Install it into the web profile:
dsh plugin --profile web add dsh-ui-notify
Then restart the profile (dsh --profile web) so the new package metadata is picked up. No build step is needed — the published tarball ships the built lib/ (node half + browser client bundle + type declarations).
To update to a newer release:
dsh plugin --profile web up dsh-ui-notify
Configuration
All settings live under the Notifications row (General settings), stored in localStorage under dsh-ui-notify.settings:
| Field | Values | Default |
|---|
| Enable reminders | on / off | on |
| Sound | None, Chime 1–3 | Chime 1 |
| Volume | 0–100% | 50% |
| Remind when | Background session finishes / Any session finishes | Background |
The first user gesture unlocks the audio (browser autoplay policy); a completion that rang before unlock is queued and played on the next gesture.
Development
pnpm install
pnpm run typecheck
pnpm run test
pnpm run build
pnpm run build runs the two-project TypeScript build (node half + browser half) then bundles lib/client.js with tsdown. pnpm run prepare is the self-contained consumer build: it transpiles both halves from source without the type-checked peer graph, for installs that build from source rather than the npm tarball.
Changelog
See CHANGELOG.md for release history.
License
MIT
