DSH Plugins Marketplace

DSH Plugins

Plugins

/

Notifications & Integrations

/

dsh-desktop-notify

d

dsh-desktop-notify

Manifest valid

Sends a desktop notification when a turn finishes or the agent waits for your choice, and a click returns to that conversation.

UI (client)hasBundlePatch

简体中文 · English

dsh-desktop-notify: a bell in a rounded tile next to the project name

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.

Star this repository Latest release Checks MIT license Open issues Last commit macOS, Windows, Linux DeepSeek Harness plugin

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

EventBodyClick
A turn finishes<conversation> · finishedOpens that conversation
A question, approval, plan review, or action card starts waiting<conversation> · waiting for your choiceOpens 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

  1. In DSH, open Plugins → Discover → Add index source.
  2. Paste the index URL:
https://raw.githubusercontent.com/chengzhi43/dsh-desktop-notify/main/index.json
  1. The list now contains dsh-desktop-notify. Choose Install. Every entry pins a commit, so the installed files match the listed version.
  2. 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

  1. Download dsh-desktop-notify.zip from the latest release.
  2. Unzip it into a directory that can remain in place.
  3. In DSH, open Plugins → Add plugin and select that directory. Its root must contain package.json.
  4. 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.sessionStatus falls 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://open call, 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

dsh-notify-me

by chromoany

Desktop notifications, sounds and a tab-title marker when the agent needs your input or a reply finishes in the background.

Notifications & IntegrationsManifest valid

★ 144

↓ 7.4k/wk

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add dsh-notify-me

by 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

Notifications & IntegrationsManifest valid

★ 0

MIT

JavaScript

Nov 18, 2026

dsh plugin --profile web add dsh-notify-context

OS-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.

Notifications & IntegrationsManifest valid

★ 0

dsh plugin --profile web add @deepseek-ai/dsh-client-ui-notifications

Desktop 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)

Notifications & IntegrationsManifest valid

★ 2

↓ 562/wk

MIT

JavaScript

dsh plugin --profile web add dsh-notification

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 fengnowuyu-beep

Windows 桌面通知 + 分场景提示音 + 点击跳回对话:对话完成、出错、等待审批、等待确认(计划评审)、等待回答、需要登录 · Desktop notifications with a distinct cue per DSH event; click one to reopen its conversation

Manifest valid

★ 0

MIT

JavaScript

Nov 16, 2026

dsh plugin --profile web add dsh-windows-notify