dsh-plugin-desktop-notify

Desktop notifications and an app-icon badge for DSH: a finished turn, a pending approval or question, and a failure, with click-through back to that session.

(A real screen recording, cropped to the notification area.)

What it does

• Turn finished — including while the window is backgrounded or another app is in front
• You are needed — a tool approval, a question, or a plan waiting for confirmation
• Turn failed — the error is summarised in the body
• Badge — the app icon carries the number of sessions that need you, cleared once you have looked
• Click a notification — it switches to that session instead of only raising the app

Subagent sessions are skipped by default.

Install

DSH desktop → Plugins → Install, then paste the package name:

dsh-plugin-desktop-notify

Press ⌘R afterwards. The GitHub address (https://github.com/chendaleiQ/dsh-plugin-desktop-notify) and an absolute local directory work the same way.

Preferences

Stored in localStorage under dsh-plugin-desktop-notify.preferences:

Language

The copy follows DSH's language setting (Settings → General → Language): Chinese by default, English once the app is switched.

Self-check

From the renderer console:

__DSH_DESKTOP_NOTIFY__.capabilities()
__DSH_DESKTOP_NOTIFY__.state()
__DSH_DESKTOP_NOTIFY__.report()

Notification interface for other tools

The Host half exposes two loopback routes for scripts, browser agents and cron jobs:

The address is written to ~/.dsh/desktop-notify.endpoint, so callers never guess the port:

curl -s "$(cat ~/.dsh/desktop-notify.endpoint)" \
  -H 'content-type: application/json' \
  -d '{"title":"BrowserOS needs you","body":"A takeover request is waiting"}'

Python:

import json, pathlib, urllib.request

url = pathlib.Path.home().joinpath(".dsh/desktop-notify.endpoint").read_text().strip()
request = urllib.request.Request(
    url,
    data=json.dumps({"title": "BrowserOS needs you", "body": "A takeover request is waiting"}).encode(),
    headers={"content-type": "application/json"},
)
urllib.request.urlopen(request, timeout=3).read()

Notes:

• The banner is posted by DSH itself (attributed to DeepSeek Harness), not by a script host
• Clicking it raises the window; with sessionId it also switches to that session
• The interface binds loopback only and needs no login; enabled: false switches off the osascript fallback, not the interface

Known limits

• Windows: clicking a notification switches the session, but the window does not always come to the front — the AppUserModelID and a main-process focus channel are the desktop app's to provide
• Attribution: the notification centre shows DeepSeek Harness, because the banner is a renderer-side native notification
• Host half (index.js, an osascript fallback) is off by default; switch it on only when a renderer cannot post notifications

Development

node test/client.test.mjs
node test/host.test.mjs

License

MIT · https://github.com/chendaleiQ/dsh-plugin-desktop-notify