dsh-web-ui-notify — Desktop notifications for approvals / questions / turn completion

Install: dsh plugin --profile web add github:omdsh-dev/dsh-web-ui-notify

A DeepSeek Harness Web UI client plugin: when a tool needs approval, DSH asks you a question, or a turn finishes while you are looking at another tab, it pops a system desktop notification — so neither DSH nor you end up waiting.

English | 中文

Why this exists

While you browse other pages, DSH needs human confirmation (tool approvals, questions) or finishes a round of work, and the Web UI in the foreground tab is the only place it asks. If you are looking anywhere else, the request waits silently. This plugin moves those moments onto your desktop: a native system notification appears, names the session, and clicks back into the conversation.

Features

• Notify on interaction with the current session: tool approvals and DSH questions carry context in the body (approvals show the over-permission reason, questions show the question text)
• Notify on background sessions too: sessions you are not looking at also notify when they need approval or a question (same contextual body as the current session); a finished background session notifies as well — click it to jump straight to that session
• Notify on turn completion: every finished turn of the current session notifies, with the first 80 characters of the final answer; tool-only turns without a final answer show the turn number. Completion, interruption, and error turns all notify
• Session name in the title: every notification title names its session, e.g. "Refactor database · needs approval"
• Click to jump to the session: clicking a notification not only returns to the DSH page but also opens that session
• Notifies only while you are away from the tab; when the page is in the foreground DSH already shows its own prompts, so it does not double-notify
• Each event notifies once — reconnects do not repeat it, and opening a session with history does not replay old turns
• Notifications do not auto-dismiss after a few seconds; they wait for you
• A toggle lives in Settings → General, following the DSH language (zh/en)

Install

The plugin is a DSH bundle (package.json declares dsh.bundle + dsh.client). Install it into the web profile with the standard dsh plugin mechanism — no DSH source changes and no hand-written patch:

dsh plugin --profile web add github:omdsh-dev/dsh-web-ui-notify

Internally the command runs pnpm add <spec> in the profile directory and automatically appends packages that declare dsh.bundle to dsh.profile.bundles. You can also clone it and install from a local path (for development — rebuild and it takes effect):

dsh plugin --profile web add /path/to/dsh-web-ui-notify

The repository ships its build output (lib/), so the plugin works right after installing — no build step needed. It has zero runtime dependencies: the browser-side requires (react, react/jsx-runtime, ui-slots) resolve through DSH's own frontend module table, not npm.

Older DSH (before the profile system) installed via pnpm --filter @deepseek-ai/dsh add + config.yaml; since the 20260806 snapshot the profile flow above is the way. If your DSH is still old, use the historical README (visible in git history).

…