dsh-desktop-notify
Manifest validSends a desktop notification when a turn finishes or the agent waits for your choice, and a click returns to that conversation.
简体中文 · English
dsh-desktop-notify
DeepSeek Harness sessions run in the background. The plugin reports the two moments that need you: the turn finished, or the agent is waiting for your choice.
A star helps the next person who needs this plugin find it.
A session commonly runs for several minutes. While the window is in the background, two events matter: the turn finishes, or the agent stops and waits for an answer. The plugin delivers both through the system notification center, and a click returns to that conversation.
It is a client-side bundle: one directory, no dependencies, no build step, no network requests, and nothing written to disk.
Notification content
| Event | Body | Click |
|---|---|---|
| A turn finishes | <conversation> · finished | Opens that conversation |
| A question, approval, plan review, or action card starts waiting | <conversation> · waiting for your choice | Opens that conversation |
The title is always DeepSeek Harness; the body carries the conversation name and the state. The state text follows the application language, currently eight of them. Subagent conversations are excluded, and a pending request that is published again does not produce a second notification.
Install
Two methods are available. Either one produces the same plugin directory.
Option 1: install from the index link
- In DSH, open Plugins → Discover → Add index source.
- Paste the index URL:
https://raw.githubusercontent.com/chengzhi43/dsh-desktop-notify/main/index.json
- The list now contains
dsh-desktop-notify. Choose Install. Every entry pins a commit, so the installed files match the listed version. - Allow notifications in the system settings, as described below.
The index file can be inspected directly at index.json.
Option 2: install from the bundle directory
- Download
dsh-desktop-notify.zipfrom the latest release. - Unzip it into a directory that can remain in place.
- In DSH, open Plugins → Add plugin and select that directory. Its root must contain
package.json. - Reload the window with
Cmd/Ctrl + R.
For both methods, the operating system must permit notifications from the application: macOS System Settings → Notifications → DeepSeek Harness, Windows Settings → System → Notifications.
Platform verification, including the open Windows toast question, is recorded in docs/WINDOWS-VERIFICATION.md.
How it works
DSH client (open page)
uiSession.sessionStatus running + highest-precedence pending interaction
dsh-desktop-notify diff one snapshot against the previous one
Notification "<title> · finished" / "<title> · waiting for your choice"
click uiWorkspace.openSession(sessionId)
fallback: sessions.list running state only, completions still announced
The plugin keeps a small map in memory and compares each snapshot with the previous one. A running value that changes from true to false indicates a finished turn; a new pending-interaction key indicates that the application expects an answer. No state is persisted, and unloading the bundle removes the subscription.
The state it reads is the one the application already publishes, the same source behind the sidebar indicator and the pending panel in the composer. Approval prompts and plan reviews are covered for that reason: they share this status, so no separate handling is required.
Requirements and limits
- DeepSeek Harness desktop 0.2.2-rc.3 or newer. That is the release this plugin was developed and verified on, and the bundled runtime reports the same version. Earlier builds have not been tested; a build without
uiSession.sessionStatusfalls back to the conversation list and then reports completions only, without the waiting state. - Notifications originate from the open page. When the window is closed or the application quits, no notification is delivered, although the session continues to run on the host.
- There is no sound setting, no per-conversation mute, and no quiet hours. A pending request notifies once, and repeated publication of the same state stays silent.
- On Linux, delivery depends on the desktop notification service and on whether it reports clicks back to Electron.
- In a browser tab, the first notification passes through the browser permission prompt.
- On Windows, a window minimized to the tray may not come forward on click. Raising it requires a
dsh://opencall, which this plugin does not make. - The plugin adds no model-facing text, sends no telemetry, and reads no credentials.
Local verification
git clone https://github.com/chengzhi43/dsh-desktop-notify.git
cd dsh-desktop-notify
node --check client.js
node test/harness.cjs
The harness replaces the client services with stubs, so it runs without a DOM, Electron, or DSH. It covers completion, pending choice, duplicate suppression, subagent exclusion, click navigation, teardown, and the fallback path. CI runs the same commands on Linux and validates the index file; see .github/workflows/checks.yml.
Contributing
Issues in Chinese or English are both acceptable. For code changes: keep the bundle dependency-free and client-side, keep the status comparison as the only source of state, and add an entry to CHANGELOG.md. A new kind of notification usually means the application gained a new pending interaction rather than that this plugin needs more code.
License
MIT. Use, fork, and redistribute it inside your own setup.
If the plugin is useful: star the repository, watch releases for updates, and open an issue when a notification is missing or repeatedly noisy.
Comments
Loading…
Similar plugins
by chromoany
Desktop notifications, sounds and a tab-title marker when the agent needs your input or a reply finishes in the background.
★ 144
↓ 7.4k/wk
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add dsh-notify-meby 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-contextOS-level system notifications for the dsh web GUI: popups when a turn finishes or the agent needs your approval, answer, or plan review while the page is in the background.
★ 0
dsh plugin --profile web add @deepseek-ai/dsh-client-ui-notificationsDesktop and webhook alerts on macOS, Linux and Windows when an agent finishes a turn, errors, or waits for approval — zero-dependency native notifications (osascript / notify-send / PowerShell toast)
★ 2
↓ 562/wk
MIT
JavaScript
dsh plugin --profile web add dsh-notificationby 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 fengnowuyu-beep
Windows 桌面通知 + 分场景提示音 + 点击跳回对话:对话完成、出错、等待审批、等待确认(计划评审)、等待回答、需要登录 · Desktop notifications with a distinct cue per DSH event; click one to reopen its conversation
★ 0
MIT
JavaScript
Nov 16, 2026
dsh plugin --profile web add dsh-windows-notify