@uachar/dsh-ui-chime
A browser chime plugin for DeepSeek Harness: a short synthesized "ding" plays when the model reaches a boundary you care about — a completed turn, or a point where it is waiting for you. No audio assets, no session-log writes, no changes to the dsh core; installed as a standalone package.
Features
- Rings when a full turn completes (
turn/endwithcompleted/max-tokens) — the intermediate thinking phases of multi-step turns stay silent. - Rings when an approval is requested (
approval/asked) — the model is waiting on a permission decision. - Rings when the model calls
ask_user_question(tool/call) — it is waiting for you to pick an option. - Volume control with instant preview; setting persists across sessions.
- Synthesized with Web Audio (oscillators + gain envelope) — zero audio files, no added asset weight.
- History replay (opening a session, pagination, reconnect) never rings: an event counts as live only if it is within 10 seconds of now.
How to use
- Volume control: the composer tool row has a speaker button (Windows-style line icon) on the left; click it to open a slider. Dragging the slider plays a preview chime at the new volume, so you can hear the level as you adjust. The setting persists in
localStorage(dsh.ui-chime.volume). - Autoplay policy: browsers keep
AudioContextsuspended until the first user gesture, so the chime is silent before the page has been clicked once — click anywhere and it works afterwards.
Installation & removal
> Requires a working dsh CLI (pnpm) and a profile, e.g. web.
Install from npm (recommended)
pnpm dsh plugin --profile web add @uachar/dsh-ui-chimeInstall from the GitHub release tarball
pnpm dsh plugin --profile web add https://github.com/uAcharGG/dsh-ui-chime/releases/download/v0.1.0/uachar-dsh-ui-chime-0.1.0.tgzBuild & install from source
git clone https://github.com/uAcharGG/dsh-ui-chime.git
cd dsh-ui-chime
pnpm install
pnpm run build # tsc -> tsdown; emits lib/index.js and lib/client.js
pnpm dsh plugin --profile web add link:<absolute path to this checkout>Restart dsh after any install to take effect.
Removal
pnpm dsh plugin --profile web remove @uachar/dsh-ui-chimeThen restart dsh. (Enable/disable via the manager panel only edits the composition layer without removing the code.)
Project structure
| File | Purpose |
|---|---|
cordis.patch.yml | bundle composition layer: inserts the plugin as one ui-chime row |
src/index.ts | host half: empty apply (so the row appears in the Host loader / dsh.client scan) |
src/client/index.ts | browser half: headless Conversation Definition (ring triggers) + volume control registration |
src/client/chime.ts | Web Audio synthesis engine + persisted volume |
src/client/volume-control.tsx | speaker button and volume slider in the composer tool row |
lib/ | build output (published) |
Limitations
- Autoplay policy — the first chime before any user gesture is silently skipped (the unlock listeners make the next one ring).
- Boundary events only — the triggers are
turn/end,approval/asked, andask_user_questiontool calls; a step interrupted mid-reasoning never rings. - No per-session control — the chime rings for every session at one loudness (volume is global, persisted in localStorage).
License
MIT