omdsh-dev/dsh-notification
495Last commit Aug 13, 2026
dsh-notification DSH plugin
dsh-notification adds system notifications to the DeepSeek Harness web GUI when a session completes a turn. It requires no harness changes: the host contributes a session projection and the client watches the session list's completion reminder. Settings are available under Settings > Notifications, including outcome filters, keyword rules, and manual dismiss options.
How to install the dsh-notification DSH plugin
dsh plugin --profile web add https://github.com/omdsh-dev/dsh-notification/archive/refs/tags/v0.1.2.tar.gzCopying does not run this command. Review the repository and version before installing the dsh-notification DSH plugin.
dsh-notification DSH plugin data source
dsh-notification DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-notification DSH plugin can do
- Shows system notifications when a session finishes a turn, using the browser Notification API.
- Allows filtering by turn-end reason: completed, error, aborted, blocked, or token limit, each toggleable.
- Supports include/exclude keyword rules that match against session title, reply text, and tool names, with literal or regex matching.
- Option to require manual dismiss or auto-dismiss, and to suppress notifications when the session is in view.
Where the dsh-notification DSH plugin fits
- Know when a long-running session finishes without staying on the DSH tab.
- Filter out notifications for routine completions and only get alerted for errors or blocked states.
- Avoid notification spam by setting keyword exclusions for common patterns like 'test' or 'preview'.
Who the dsh-notification DSH plugin is for
- DSH users who multitask across multiple browser tabs.
- Users who want fine-grained control over which completions trigger desktop notifications.
dsh-notification DSH plugin limitations
- Notifications require the page to be open and Notification permission granted; a denied permission cannot be overridden from within the page.
- Notifications fire only once per finished turn (running→idle edge); completions that occurred while the page was disconnected are not re-notified on reconnect.
- Rule matching applies only to the session title and the last turn's reply text and tool names—earlier turns are not considered.
- Notification body is a flat text snippet; clicking the notification only focuses the window, not the specific turn.
dsh-notification DSH plugin: from the repository README
Quoted from the omdsh-dev/dsh-notification README, the upstream source of the dsh-notification DSH plugin. Copyright remains with the original authors.
Desktop notifications for the DeepSeek Harness web GUI. When a session finishes a turn, the browser shows a system notification (via the `Notification` API), so you can switch tabs and still know when DSH is done. Per-outcome toggles and include/exclude keyword rules control exactly which completions notify. No harness change is needed: the host contributes a session projection (a bounded summary of each session's last completed turn), and the client watches the session list's completion reminder and applies its own persisted preferences. ``` host: notification projection (last turn's reason/text/tools) --session/projection--> browser client: session list completion reminder (live, dedup) + persisted settings -> permission + current-session visibility gate -> new Notification("DSH finished", { body: "deploy done" }) ``` ## Install ```sh dsh plugin --profile web add https://github.com/omdsh-dev/dsh-notification/archive/refs/tags/v0.1.2.tar.gz ``` Restart the web server so the host half and the served client bundle pick up the plugin. The default `dsh web` profile has the required client composition (the session list, the settings shell, and locale). The settin
Read the full READMERepository license: MIT
dsh-notification DSH plugin questions
How do I install dsh-notification?
Run the command `dsh plugin --profile web add https://github.com/omdsh-dev/dsh-notification/archive/refs/tags/v0.1.2.tar.gz` in your DSH environment. Then restart the web server so the host and client bundle load the plugin. The settings will appear under Settings > Notifications.
Why aren't notifications showing up?
First, make sure your browser has granted notification permission for the DSH web page. If you previously denied it, you need to manually enable it in your browser's site settings (the plugin cannot override a denied permission). Also check that the master switch in Settings > Notifications is turned on, and that the specific outcome types you care about (e.g., 'completed' or 'error') are enabled.
Can I get notified only for errors and not for successful completions?
Yes. In Settings > Notifications, under 'Notify on completed / error / aborted / blocked / token limit', disable 'completed' and enable 'error' (and any others you want). Notifications will then only fire for turns ending in that state.
How do I stop notifications for a specific session or keyword?
You can add exclude keyword rules. For example, if a session title contains 'test', add an exclude rule with the literal text 'test'. The rule matches against the session title, the last turn's reply text, and tool names. Exclude rules suppress the notification if a match is found. You can also use regex patterns for more complex matching.
Will notifications work if I close the browser tab?
No. Notifications require the page to be open (even if hidden). If you close the tab or the browser, no notifications will be shown. The plugin uses the browser Notification API, which only works while the page is alive.