Introduction¶

When running long tasks in DSH, a common problem is having to go back to the dsh web page to confirm the status after the task ends. Once you switch away from the window, the spinner or session status inside the page doesn’t always alert you immediately.

dsh-notify solves this scenario: it automatically pops up native Windows Toast notifications when the agent stops running; meanwhile, a whale icon remains in the taskbar for quick access to dsh web or exiting the background.

What is this¶

dsh-notify is a DSH plugin published by Pasumao, with the npm package name dsh-notify and an MIT license.

It targets Windows 10/11, requires Node ≥ 22.5, and is documented as tested on DSH 0.1.1-rc.2. It primarily solves two problems:

Remind users via native Windows Toast when the agent stops running;
Provide an entry point to invoke dsh web or exit the background via the system tray whale icon.

Core Features¶

Native Windows Toast Notifications¶

When the agent stops running, the plugin automatically pops up system notifications. The trigger states listed in the documentation include:

Completion;
Stop;
Error;
Output limit reached;
Pending user choice;
Session closed.

The notification body will be tagged with “Workspace · Session” to help distinguish multiple workspaces or sessions.

System Tray Whale Icon¶

A whale icon will remain in the taskbar. The right-click menu allows:

Invoking the dsh web page;
Exiting the background.

The tray icon is controlled by the tray configuration option, with a default value of true.

Anti-Spam Controls¶

The plugin provides two common control options:

rootsOnly: Default true, notifications only for root sessions, avoiding spam from child agents;
cooldownMs: Controls the minimum interval between two notifications of the same session and type.

Lightweight Installation¶

The documentation states that this plugin has zero runtime dependencies and zero build requirements; it is ready to use immediately after installation.

It declares in package.json:

"peerDependencies": {
  "@deepseek-ai/cordis": "^4.0.1"
}

Installation and Enablement¶

Below are three installation methods.

Install via npm package name¶

Run:

dsh plugin --profile web add dsh-notify

This step installs dsh-notify into the specified web profile.

Install from GitHub repository¶

Run:

dsh plugin --profile web add github:Pasumao/dsh-plugin-notify

This step is suitable for installing the plugin directly using the repository address.

Install from Source¶

If local debugging is needed, clone the source code:

git clone https://github.com/Pasumao/dsh-plugin-notify.git
cd dsh-plugin-notify
npm install

Then mount it into the profile using the link: method, keeping the package name dsh-notify.

Enable and Verify¶

After installation, restart dsh web. If a whale icon appears in the taskbar, the plugin is active.

Typical Usage and Self-Testing¶

After installation, you can use the project script to pop three real Toasts for self-testing:

node scripts/test-harness.mjs

If you need to adjust notification behavior, you can override the config in the profile’s cordis.patch.yml by id dsh-plugin-notify.

Common configuration options listed in the documentation are:

cooldownMs: Default 10000, indicating the minimum interval between two notifications of the same session and type;
rootsOnly: Default true, notifications only for root sessions;
tray: Default true, tray icon toggle;
titlePrefix: Default 'dsh', title prefix for notifications.

Applicable Scenarios and Notes¶

Suitable for the following scenarios:

Running long generation or batch processing tasks for LLMs where you want to switch windows and be reminded by system notifications at the end;
Multiple workspace sessions running in parallel, wanting to distinguish results by the “Workspace · Session” tag;
Need a persistent entry in the taskbar to quickly invoke dsh web or exit the background.

Pre-use notes:

This plugin runs with the current dsh process permissions; it is recommended to check the source code, dependencies, and license before installing;
Notifications rely on Windows notification settings and PowerShell notification permissions; Focus Assist or Do Not Disturb may block them;
The tray icon depends on the tray configuration (default true); if overridden, the icon might not appear;
The documentation mentions that the code and documentation were generated with AI assistance (DeepSeek Harness) and have undergone manual review and real-device testing.

Frequently Asked Questions¶

Not receiving notifications?¶

Check if Windows “Settings → System → Notifications” allows PowerShell to display notifications, and if you are not in Focus Assist / Do Not Disturb mode.

Only want notifications for root sessions?¶

Keep:

rootsOnly: true

Change to:

rootsOnly: false

when you need to monitor child agents.

Notifications too frequent?¶

Increase cooldownMs. The default value provided in the documentation is 10000.

Tray icon missing?¶

First, restart dsh web. If the icon is still missing, check if the tray configuration has been overridden to false.

Conclusion¶

The value of dsh-notify is quite straightforward: turning the agent stop event into a native Windows Toast and providing a persistent whale icon entry for the background. For those running long DSH tasks on Windows but don’t want to stare at the dsh web page constantly, this is a ready-to-install DSH plugin.

dsh-notify: Windows Native Toast and System Tray Plugin for DSH