DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-octagon-alerts

h

dsh-octagon-alerts

Manifest valid

Session chimes for choice, approval and completion — a DeepSeek Harness client plugin.

UI (client)hasBundlePatch

dsh-octagon-alerts

A DeepSeek Harness client plugin that plays a short synthesized chime when a Session changes what it needs from you:

  • needs an answer (question / plan review) — two rising bell notes
  • needs approval (permission for a tool call) — three even knocks
  • finished its turn — a softer descending pair. By default it only plays when you are not looking at that Session (window in the background or another Session selected); Settings → General → Completion chime can switch it to every turn

Each moment picks its own chime: Settings → General has one picker per alert kind, offering eight synthesized presets (Knock, Bell, Soft descent, Arpeggio, Drop, Deep, Marimba, Pulse) with a Preview button and a Volume slider per row (0–200%, where 100% is the default and 200% doubles it). The same preset can be shared across the three moments or all three can differ, and each moment can be quieter or louder than the others.

A speaker toggle sits in the Session header utilities, beside the other header actions. It mutes every Session at once (the preference is stored in localStorage under dsh:sound-alerts:settings:v1 and survives reloads); unmuting plays one confirmation note. Five rows in Settings → General mirror the preferences: a mute switch, the three chime rows (preset, volume, preview) and the completion-chime timing. Subagent Sessions stay silent, and at most one chime plays per status change (approval > question > completion).

Install

Install from npm (fastest, served by the registry CDN):

dsh plugin add @octagon-teams/dsh-octagon-alerts

Or straight from the repository, no registry involved:

dsh plugin add github:hexa-center/dsh-octagon-alerts

or, from the prebuilt archive attached to the latest release (faster, no source download):

dsh plugin add https://github.com/hexa-center/dsh-octagon-alerts/releases/latest/download/dsh-octagon-alerts.tgz

Once the catalog entry is live, Plugin Manager → Plugin Market lists it as dsh-octagon-alerts under Notifications. Installing from a local checkout also works (dsh plugin add /path/to/dsh-octagon-alerts).

Slow or blocked GitHub

A profile dependency that points at a remote .tgz URL is re-resolved with an HTTP HEAD on every install, and DSH runs that install while it boots. Where release-assets.githubusercontent.com is resettable (mainland China, for one), that HEAD turns into a 10s + 60s retry cycle and a slow or failed start.

Install the same archive from a local file instead — it pins the tarball by path, so startup never touches the network:

curl -LO https://github.com/hexa-center/dsh-octagon-alerts/releases/latest/download/dsh-octagon-alerts.tgz
dsh plugin add ./dsh-octagon-alerts.tgz

Swap the file and reinstall to update. Keep the file where you put it: the profile references that exact path.

How it works

client.js subscribes to ctx.get('uiSession').sessionStatus — the Browser-side Session status snapshot (running, pendingInteraction, completionUnread) — and diffs consecutive snapshots. Audio is synthesized with the Web Audio API, so no asset files or network requests are involved. A base gain of 3 is applied to every envelope, so the default 100% is already 1.5× the original level and 200% is another doubling on top of that. The audio graph is primed on the first click or keystroke, because browsers block audio until the page has been interacted with.

Layout

package.json                bundle manifest (host row + client half)
cordis.patch.yml            inserts the host row
index.js                    host half (no Host behaviour)
client.js                   browser half: status diff, chime synth, header toggle
locale/{en,zh}.json         plugin card title / description / detail
docs/                       one-image detail page (DETAIL.md, DETAIL.zh.md),
                            preview illustration, release checklist
test/                       Node tests for the diff, voices and toggle semantics

Tests

node --test test/client.test.mjs

The test stubs React, AudioContext and the Cordis context, then drives uiSession.sessionStatus through the real transitions (question, approval, watched vs. away completions, per-Session guard, mute, subagents, teardown) and asserts the chime pickers (per-kind preset resolution, unknown-id fallback, preview), the per-kind volume (envelope scaling, clamping, inaudible at 0%), the toggle's switch semantics and locale strings.

License

MIT

Comments

Loading…

Similar plugins

dsh-plugin-notify

by GooDAnDReaDY

DSH plugin: audio chimes, cross-session toasts, desktop push, and IM webhooks for turn completion, errors, and approvals.

Development & InfrastructureTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Sep 25, 2026

dsh plugin --profile web add @goodandready/dsh-plugin-notify

by DevTarlow

A DeepSeek Harness plugin that chimes when an agent finishes answering.

Manifest valid

★ 0

MIT

JavaScript

Nov 2, 2026

dsh plugin --profile web add dsh-response-chime

by Ruiming-cn

DSH (DeepSeek Harness) plugin — Windows toast + chime the moment the agent needs you: turn done, blocked, error, approval, question, plan review.

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Aug 25, 2026

dsh plugin --profile web add dsh-turn-notify

by ChuxueTeam

DeepSeek Harness 插件 · 需要你本人回到电脑前时弹窗并出声喊你,提示音一直响到你亲手关掉。 | DSH plugin: pops a card and rings on loop until you dismiss it.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 5, 2026

dsh plugin --profile web add dsh-caller

by hujiyo

DeepSeek Harness plugin: browse, search, copy and hide the prompts you sent to the AI across all sessions.

Manifest valid

★ 0

MIT

JavaScript

Oct 20, 2026

dsh plugin --profile web add dsh-recent-prompts

by abalika

A community plugin for DeepSeek Harness Desktop: switch between Harness and official DeepSeek Chat, with optional persistent login on Windows.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add dsh-mode-switch