dsh-plugin-notify

dsh-notify

中文 | English

Native Windows toast notifications for dsh: when the agent stops running (finished / aborted / error / waiting for your choice / session closed), a native Windows Toast pops up automatically with the body labeled "workspace · session" — switch away from the window during long tasks and one glance at the toast tells you whether it's done.

Zero runtime dependencies, zero build; one dsh plugin add command and it's ready to use.

Screenshot

Real Windows Toast capture: the body is labeled "workspace · session".

Features

• Native Windows Toast notifications: when the agent stops running (finished / aborted / error / output limit reached / waiting for your choice / session closed), a system notification pops up automatically with the body labeled "workspace · session" — tell at a glance which session finished;
• Anti-spam: rootsOnly defaults to notifying only root sessions, so subagents won't flood you; cooldownMs sets the minimum interval between two notifications of the same type in the same session;
• Security hardening: the notification child process runs with a sanitized environment (variables whose names contain KEY / SECRET / TOKEN / PASSWORD are stripped, preventing credential leaks) — no leftover credentials or stray processes;
• Windows environment system-prompt section: injects a short Windows environment essentials section (encoding / path / process guardrails) into the agent's system prompt, toggled together with the master enabled switch;
• Zero runtime dependencies, zero build: one dsh plugin add command and it's ready to use.

Use cases

• Switch windows during long tasks: while a long LLM generation / batch job runs, switch to another app; when it ends, a toast pops up and one glance tells you the result;
• Unattended batch jobs: run multiple rounds overnight and get a Toast when everything is done — no need to keep watching the page;
• Multiple sessions at once: run several workspace sessions simultaneously; each notification body carries the "workspace · session" label, so nothing gets mixed up;
• Watching subagents: keep the default rootsOnly: true when you only care about root-session results, and turn it off when you need to watch subagents.

Installation

dsh plugin --profile web add dsh-notify

Install from GitHub: dsh plugin --profile web add github:Pasumao/dsh-plugin-notify

Install from source (local development / debugging):

git clone https://github.com/Pasumao/dsh-plugin-notify.git
cd dsh-plugin-notify
npm install
# Mount into the profile as a link: dependency (package name: dsh-notify)

After installing, restart dsh web and the plugin is active.

Compatibility: Windows 10/11 · Node ≥ 22.5 · tested on DSH 0.2.0-rc.2.

Configuration

Override the config in the profile's cordis.patch.yml under the id dsh-plugin-notify. Common options:

Testing

node scripts/test-harness.mjs   # Fires three real Toast notifications as a self-test

FAQ

• Not receiving notifications? Check that Windows "Settings → System → Notifications" allows PowerShell to show notifications, and that you are not in Focus Assist / Do Not Disturb mode;
• Only root-session notifications? Keep the default rootsOnly: true; change it to false when you need to watch subagents;
• Notifications too frequent? Just increase cooldownMs (default 10000ms).

Related plugins

This plugin is part of the Pasumao dsh plugin ecosystem; the published plugins in the series work well together:

For the other plugins in the series, see Pasumao · dsh plugins; if you find them useful, a ⭐ on GitHub is appreciated.

AI-generated disclosure

The code and documentation were generated with AI assistance (DeepSeek Harness), all human-reviewed and verified on a live machine (scripts/test-harness.mjs fires real Toast notifications as a self-test).

License

MIT