dsh-session-bell
Manifest validRaises one desktop notification when a turn stops, a question waits, or an approval waits. Each event has its own switch; subagent Sessions stay quiet; a click opens the Session. Uses the page's own N
dsh-session-bell
English | 简体中文
Desktop notifications for DeepSeek Harness.
A turn that finishes, a question that waits for your answer, or an approval that waits for your decision raises one native notification. The sender is DeepSeek Harness itself, not a helper app. A click opens the Session that raised it.

What it does
| Event | Notification |
|---|---|
A turn stops (agent/turn-stopping) | Session title, then the first sentence of the last assistant text |
A question waits for a human (user-questions/request) | Session title, then the question |
An approval waits for a human (approval/request) | Session title, then the tool name |
- Every root Session can report. Subagent Sessions stay quiet for all three events; their parent turn still reports.
- Notifications are keyed by Session: a newer event for a Session closes that Session's previous banner, whatever its kind.
- Click: focus the window, then select that Session in the Conversation panel.
- The body is plain text: Markdown marks are removed, then the text is clipped to 80 characters. A turn-end body keeps its first sentence, a question is not cut at a sentence, and an empty body falls back to the localized label.
Settings
Open More → Settings, then choose Notifications in the settings sidebar.

| Switch | What it does |
|---|---|
| Turn finished | Notify when a turn stops. |
| Question | Notify when a question waits for an answer. |
| Approval | Notify when an approval waits for a decision. |
| Only notify while this window is in the background | When on, a focused window shows no notifications. When off, every event notifies. Default on. |
Switches apply immediately; there is no save button. Settings are stored locally in the app (localStorage), not in the app configuration. The section shows the page notification permission and a Send test action; if no banner appears, see Requirements for the system permission.
Approval notifications appear only when the session asks for approval. A session whose approval policy never asks sends no approval notification.
Requirements
- DeepSeek Harness with the Web GUI (Desktop app or
dsh web). - The window must be open. The page raises the notification, so a closed window sends nothing.
- The operating system must allow notifications for DeepSeek Harness. On macOS, open System Settings → Notifications. On Windows, open Settings → System → Notifications.
Install
In DeepSeek Harness, open the Plugins page from the sidebar, choose Install bundle, and enter:
dsh-session-bell
After the first install, reload the page once (⇧⌘R). The Host half is live at install time, but the page half is a browser module and loads only with a fresh page. After an update, reload the page and toggle the plugin once. The Host half and the page half must come from the same version.
How it works
Two halves, one route.
- Host half (
index.js) listens toagent/turn-stopping,user-questions/request, andapproval/request. It turns each event into a Server-Sent Event on/session-bell/events. For approval it sends the tool name only, not the command or reason. No Web server means no route and no work, so the CLI stays silent. - Page half (
client.js) subscribes to that route, filters events by the switches, suppresses notifications while the window is focused, and raises the native notification. A newer event for the same Session closes that Session's previous banner. A click opens that Session, an empty body is localized in the page, and a closed stream reconnects by itself.
The route carries Session id, title, a clipped body, the event kind, and for approval the tool name. Settings stay in localStorage. Nothing leaves the machine; there is no network egress.
Local development
npm install
npm test
Link the directory as a bundle and toggle the plugin once:
plugin_manager install_bundle <absolute path to this directory>
plugin_manager set_plugin include:session-bell enabled:false
plugin_manager set_plugin include:session-bell enabled:true
After a change, reload the page for client.js and the plugin for index.js.
Releasing
.github/workflows/publish.yml publishes on every push to
main, but only when package.json names a version that npm does not have yet. It uses npm
trusted publishing (OIDC), so the repository stores no token, and it attaches provenance.
- Bump the version and add the CHANGELOG entry.
- Push to
main.
npm version patch # or minor, major
git push --follow-tags
One setup step lives on npmjs.com: Settings → Trusted publishing must name this repository
and the workflow file publish.yml. Without it the job fails with ENEEDAUTH.
Layout
| Path | Role |
|---|---|
index.js | Host half: events to Server-Sent Events |
client.js | Page half: settings page, notification, click to open the Session |
cordis.patch.yml | Bundle patch that inserts the Host row |
locale/*.json | Plugin Manager title and description |
icon.svg | Plugin Manager icon |
test/ | Node tests for Host events and client filtering |
License
MIT
Comments
Loading…
Similar plugins
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
★ 3
↓ 135/wk
MIT
TypeScript
Oct 20, 2026
dsh plugin --profile web add @bittersmilezzz/dsh-notifyby LeeRolling
Desktop notifications for turn completion, pending approval and pending questions, each with a per-situation title and the task summary it carries; silent while the client window is in front, and back
★ 0
MIT
JavaScript
Nov 18, 2026
dsh plugin --profile web add dsh-notify-contextby LJY4-bilibili
Raises a Windows desktop notification card when DSH asks you a question, and returns to the asking Session when the card is clicked.
★ 0
MIT
JavaScript
Oct 11, 2026
dsh plugin --profile web add dsh-message-reminderby mloluyu
DSH plugin: in-app cards & page-raised system notifications when a session finishes. Client-only, zero dependencies.
★ 0
MIT
JavaScript
Nov 18, 2026
dsh plugin --profile web add @local/session-notifyby CoCoCoDeDeDe
Desktop notifications for DSH Web sessions: browser notifications plus Windows toast when a session finishes, fails, needs an approval, or asks a question. Clicking one opens the session; browser noti
★ 2
MIT
JavaScript
Oct 24, 2026
dsh plugin --profile web add dsh-session-notifierby chenvinc
任务看板卡片结算后自动通知发起会话的 DSH 插件
★ 0
MIT
JavaScript
Oct 28, 2026
dsh plugin --profile web add dsh-task-settle-notify