Preface¶

When running tasks with DeepSeek Harness (DSH), statuses such as task completion, pending approval, and Agent awaiting response can easily go unnoticed if they only appear in the DSH interface or logs. dsh-notify-windows is a DSH plugin that sends system notifications to the Windows desktop at these key milestones, so you don’t need to keep staring at the DSH interface.

What This Is¶

dsh-notify-windows is a DeepSeek Harness (DSH) plugin maintained by SeverusZh, designed to send Windows desktop notifications when tasks complete, approvals are pending, or responses are awaited.

The documentation specifies Windows 10/11 as the supported platform. The runtime environment requires node >=20, with a peer dependency of @deepseek-ai/cordis: ^4.0.1. The license is MIT © 2026 SeverusZh.

Core Features¶

Task Completion, Error, and Output Limit Notifications¶

The plugin listens for the session turn/end event. When a task completes, encounters an error, or reaches the token output limit, a Windows desktop notification is sent. The notification title automatically uses the session title, and the body displays the reason and turn number.

Approval Request Notifications¶

The plugin listens for the approval/asked event. A notification is sent when an operation is awaiting approval.

When the approval policy is set to never, approvals are automatically rejected without waiting, and the plugin skips the notification; notifications are only sent when the policy is ask.

Agent Question Notifications¶

When the Agent calls ask_user_question and is waiting for a response, the plugin sends a notification.

The plugin scans the run_code program source for tools.ask_user_question( calls and extracts the question text for the notification.

Do Not Disturb¶

By default, the plugin ignores subagent sessions and only notifies for the main session.

If you do need notifications for subagent sessions, you can set includeSubagents to true.

Notification Delivery and Diagnostics¶

Notifications are sent via the WinRT Toast API in Windows PowerShell 5.1, and the AppUserModelId is automatically registered in HKCU without requiring administrator privileges.

Optional logging is supported, with the log path at %TEMP%\dsh-notify\notify.log. Debug event logging is also supported.

Click Notification to Navigate¶

Notifications for task completion, pending approval, and awaiting response can open the DSH Web GUI. When opened, it prioritizes focusing on an already-open DSH browser tab or Chrome Application window.

The target URL includes the ?session=<id> parameter. In the DSH 0.1.0-rc.8 frontend, this parameter is not yet consumed; clicking opens the DSH interface and focuses the existing window.

On the first click, the dshnotify:// protocol handler is automatically registered in HKCU without requiring administrator privileges. If navigation fails, it silently falls back to opening with the default browser.

WSL Support¶

In WSL environments, the plugin calls wslpath -w to convert script paths to \\wsl.localhost\... UNC paths, and preferentially invokes PowerShell via a fixed path.

Installation and Activation¶

1. Install the plugin:

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

2. Restart DSH and refresh the browser to apply changes:

dsh --profile web

Note: Do not manually add dsh-notify using - insert:, as this may result in a duplicate loader entry id: dsh-notify error.

3. Update or uninstall the plugin:

dsh plugin --profile web update dsh-notify-windows

dsh plugin --profile web remove dsh-notify-windows

After updating the plugin code, you need to run the update command and restart the DSH host.

Adjusting Configuration¶

Plugin configuration can override the main entry by ID in $DSH_HOME/profiles/web/cordis.patch.yml. This file is hot-monitored by the running DSH, so changes take effect immediately without a restart.

For example:

- id: dsh-notify
  name: dsh-notify-windows
  config:
    includeSubagents: true

Verification and Troubleshooting¶

You can run a smoke test in the plugin directory:

node scripts\smoke-test.mjs

If notifications are not received, first check the Windows notification settings, Focus Assist, and any error entries in %TEMP%\dsh-notify\notify.log.

Use Cases and Notes¶

This plugin is suitable for users on Windows 10/11 who use DSH and want desktop notifications when tasks complete, approvals are pending, or the Agent is awaiting a response.

Notes before use:

• The plugin runs with the permissions of the current dsh process; review the source code and license before installation.
• The DSH 0.1.0-rc.8 frontend does not yet support direct URL navigation to individual sessions; clicking a notification opens the DSH interface and focuses the existing window.
• When the approval policy is never, approvals are automatically rejected without waiting, and the plugin skips notifications.
• Subagent sessions are ignored by default; to receive notifications for subagents, set includeSubagents to true.

Conclusion¶

dsh-notify-windows connects the states in DSH that require human attention to Windows desktop notifications, reducing situations where “the task has finished or is waiting for input, but you’re not in front of the DSH interface.”

GitHub repository: https://github.com/SeverusZh/dsh-notify-windows

Directory page listed in the project documentation: https://www.skillhub.cn/plugins/SeverusZh/dsh-notify-windows. This community directory is an independent site and is not an official app store.