DSH Plugins Marketplace

DSH Plugins

Plugins

/

Notifications & Integrations

/

dsh-notify

d

dsh-notify

Manifest valid

Conversation notifications for DSH in one plugin: browser system notifications with per-kind sound and Bark push to the phone, classified once on the Host so both channels always agree. Quiet while th

UI (client)hasBundlePatch

dsh-notify

npm CI license

中文 | English

★ Star the repo if this saved you a plugin — that is how the next person finds it.

One notification plugin for DeepSeek Harness: browser system notifications and Bark push, decided once.

Most setups end up with two plugins — one that shows browser notifications and one that pushes to a phone. They classify events independently, so they drift: the phone reports "turn 12 ended" while the browser reports "finished", an approval arrives twice, and a subagent's chatter leaks into both. dsh-notify classifies once on the Host, then fans the same event out to every channel.

What you get

  • Browser channel — system notifications with a per-kind sound, click to jump back to the session, collapse by kind so a burst stays one card.
  • Bark channel — APNs push to your phone even with the browser closed, with a group, per-kind sounds, and an optional link back into the UI.
  • Tells you what you asked — the title is the session name with a status mark, the body is the prompt you last typed (falling back to the answer when a scheduled turn has none).
  • One event model — completed, failed, interrupted, approval, question. Each logical happening is delivered at most once.
  • Quiet by design — subagent sessions are silent, the session you are actively looking at stays quiet, and a stale presence report never hides an approval.
  • One settings page, bilingual, matching the Harness UI, with a test button per channel and masked secrets.
  • Authenticated transport — configuration and the live stream ride Connection's /api fence; there is no unauthenticated route to change your device key.

Install

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

Then reload the page and open Settings → Session alerts, paste your Bark device key, enable the channels you want, and press Test on each. The profile hot-applies the bundle, so no restart is required.

From a local checkout:

pnpm install
pnpm build
dsh plugin --profile web add ./dsh-notify

Configuration

The Host owns one JSON document in the active profile directory (~/.dsh/profiles/web/dsh-notify.json by default, or $DSH_PROFILE_DIR when set). The browser only ever receives a redacted projection: a secret shows as configured plus its last four characters, an empty field keeps the stored value, and only an explicit null erases one.

KeyMeaning
bark.baseUrlUI root a push click opens, e.g. http://127.0.0.1:3080. Empty pushes without a link.
notifySubagentsWhether sessions spawned by another session may alert. Off by default.
events.<kind>.enabledPer-kind switch for both channels.
events.<kind>.soundBrowser sound: chime, fault, pop, alert.
events.<kind>.barkSoundBark sound name; system uses the device default.
browser.enabled / browser.volumeBrowser channel and its volume (0–1).
browser.currentSessionModehidden (quiet only while the tab is visible), unfocused (quiet only while focused), always.
bark.enabled / bark.serverUrl / bark.deviceKeyBark channel and credentials.
bark.groupNotification group shown by the Bark app; defaults to DSH.

How it works

Host events ──► classifier ──► delivery policy ──► ┬─► Bark (HTTPS)
 (turn/end,      (5 kinds,      (subagent,         └─► SSE ──► browser card + sound
  approval/asked, one per         presence,
  questions)      happening)      per-kind switch)
  • The Host listens to session/event for turn/end, to the approval/request waterfall for permissions, and to user-questions/request for questions. A turn is completed only when its recorded reason says so.
  • Presence is reported by the browser (visible, focused) and expires; an expired report means "nobody is looking" and the notification goes out.
  • Transport is one SSE stream plus four JSON routes under /api/dsh-notify/*, registered through ctx.connection.fetch so Connection authenticates every request.

Requirements

  • DeepSeek Harness >=0.2.2-rc.1 <0.3.0, Node >=20.
  • A Bark app on iOS for the phone channel (the server defaults to https://api.day.app).

Development

pnpm install
pnpm test        # unit tests for the event model, policy, config, and channels
pnpm typecheck
pnpm build       # Host ESM entry + browser lazy-CJS bundle
node scripts/accept.mjs --test   # after a restart: check the live Host end to end

Layout: src/core is pure logic (no Host, no DOM, runs under vitest), src/host owns classification and delivery, src/client owns presentation.

License

MIT © 姚壬亮

Comments

Loading…

Similar plugins

dsh-notify

by bitterSmilezzz

Native desktop notifications for DSH — approvals, questions, turn completion, session end and errors — with click-to-session, per-event toggles, quiet hours, a privacy switch that keeps message text o

Notifications & IntegrationsTerminal & ClientsManifest valid

★ 3

↓ 135/wk

MIT

TypeScript

Oct 20, 2026

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

by chenyuiyu

Strikes a single short chime, raises the DSH window, floats a reminder card above the page and sends a system notification whenever the agent needs your approval or an answer. Sound and popup are two

Notifications & IntegrationsManifest valid

★ 0

MIT

JavaScript

Oct 31, 2026

dsh plugin --profile web add dsh-attention-reminder

by NattoCB

Adds a Settings card that pops a system notification and optional chime when a conversation turn completes.

Notifications & IntegrationsDevelopment & InfrastructureManifest valid

★ 1

MIT

JavaScript

Aug 21, 2026

dsh plugin --profile web add dsh-plugin-notifications

by better-er

dsh·通知叮咚插件。agent 提问或跑完一轮时,弹浏览器系统通知并让宿主进程播放 Windows 内置提示音,人跑去别的窗口时也能被叫回来;纯插件自包含,不改 DSH 源码。

Notifications & IntegrationsDevelopment & InfrastructureManifest valid

★ 2

↓ 102/wk

MIT

TypeScript

Nov 3, 2026

dsh plugin --profile web add dsh-notify-ding

Sound alerts for the DSH web UI: a chime when an answer completes and a three-tone prompt when your approval or question is pending, with optional custom WAV stored only in the local browser (pure cli

Notifications & IntegrationsManifest valid

★ 0

dsh plugin --profile web add dsh-plugin-sound-alert

by CAOGGL

Notifies you when a conversation finishes: plays a sound and shows a Windows notification when the agent goes idle (configurable sound file, volume, debounce/throttle).

Notifications & IntegrationsManifest valid

★ 12

↓ 460/wk

MIT

JavaScript

Oct 25, 2026

dsh plugin --profile web add dsh-ding