Adds Windows-native toast notifications and a system tray icon to dsh: alerts when the agent finishes, stops, or errors, with a tray menu to reopen the web page or quit the background process.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-notify
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:Pasumao/dsh-plugin-notify
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
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:
rootsOnlydefaults to notifying only root sessions, so subagents won't flood you;cooldownMssets 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
enabledswitch; - Zero runtime dependencies, zero build: one
dsh plugin addcommand 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: truewhen 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:
| key | Default | Description |
|---|---|---|
enabled |
true |
Master switch: controls both Toast notifications and the system-prompt section injection |
cooldownMs |
10000 |
Minimum interval in milliseconds between two notifications of the same type in the same session |
rootsOnly |
true |
Notify only root sessions; subagents won't flood you |
titlePrefix |
'dsh' |
Notification title prefix |
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 tofalsewhen 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:
| Plugin (npm) | GitHub | Description |
|---|---|---|
| dsh-plugin-choice-refresh | GitHub repo | Choice enhancements: regenerate options / more options |
| dsh-plugin-dev-kb | GitHub repo | Plugin development knowledge base (full mirror of official docs + skills) |
| dsh-plugin-image-tools | GitHub repo | Image choice cards + inline images in replies + image pickup for blind models |
| dsh-plugin-table-zoom | GitHub repo | Floating window for long chat tables + one-click Markdown copy |
| dsh-plugin-windows-guard | GitHub repo | Windows environment guard: rule skills + mojibake detection / dangerous-write interception / encoding diagnosis & repair |
| dsh-plugin-workbench | GitHub repo | VS Code-style file explorer + editable preview (deprecated: dsh 0.1.5 ships a built-in file tree and doc preview) |
| dsh-plugin-context-trim | GitHub repo | Per-session injection gate: trim skills / tools / prompt sections per session |
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
Links
More in this category
xmanrui/dsh-im★ 3702
Connect IM bots to DeepSeek Harness via QR codes or bot credentials (9 channels: Feishu, WeChat, DingTalk, WeCom, QQ, Slack, Telegram, Discord, and WhatsApp).
shaobeichen/dsh-pocket★ 3041
Remote phone access to the DSH Web UI: scan a QR code for LAN or public (cloudflared tunnel) access with real-time sync, a mobile-adaptive layout, and a settings tab.
c1overzz/dsh-bili-scroll★ 1446
Let your DSH agent browse Bilibili on its own, read subtitles, write a daily digest, and @ you when it finds something worth your attention.
OpenPetsHQ/openpets#dsh★ 1410
Bridges DeepSeek Harness lifecycle status, errors, and approval requests to a locally running OpenPets desktop companion.
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 606
Connects DeepSeek Harness to Avernet's Bot Collaboration Network over WebSocket V2, with automatic onboarding, isolated agent sessions, tool-call events, and multi-bot routing tools.
zaofan-make/dsh-qqbot★ 265
QQ official bot channel (enhanced fork of tencent-connect/dsh-qqbot): full agent chat in groups and DMs, rich media, an auto-tagged sticker library with AI image replies, join approval, mute and broadcast, scheduled wakeups, remote approvals over QQ, interactive cards, multi-account instances, extensions, member profiles, and token-saving value-scored wakeups.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.