DeepSeek Harness Plugin

sviktor75/dsh-sound-notification

Stars ★ 0 Category Notifications & Integrations Added 2026-10-05

Plays a chime when any session's response finishes (rising tone) or a question/approval is asked (falling tone), with a click-to-mute badge.

Install

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:sviktor75/dsh-sound-notification

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

A DeepSeek Harness Web UI plugin that plays a short chime when any session's response finishes — so you hear it even when you're not in front of the machine.

Features

  • Distinct two-note sine chimes, for any session — including ones you are not currently viewing:
    • Response finished: rising (880 Hz → 1318.51 Hz)
    • Question / approval asked: down-up (987.77 Hz → 783.99 Hz → 987.77 Hz)
  • Speaker badge in the composer dock: click to mute/unmute
  • Mute preference persists per browser (localStorage)
  • Audio is unlocked on your first click/keypress (browser autoplay policy) and can never take the UI down (all audio paths are exception-guarded)

Install

dsh plugin --profile <your-profile> add github:sviktor75/dsh-sound-notification

No build step is required — the package ships plain JavaScript.

To pin a specific commit (recommended for stability):

dsh plugin --profile <your-profile> add github:sviktor75/dsh-sound-notification#<commit-sha>

Files

File Purpose
package.json Bundle manifest (dsh.bundle + dsh.client)
cordis.patch.yml Inserts the plugin row into the composition
index.js Host half (no-op; the Client module owns the chime)
client.js Client half: Web Audio chime, status watching, mute badge
locale/en.json Plugin metadata for the plugin manager

License

MIT — see LICENSE.

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.