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-notifyThen 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-notifyConfiguration
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 buildpnpm 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](CHANGELOG.md) for release history.
License
MIT