Plugin directory / Developer / dsh-approval-notify
dsh-approval-notify
Verified · install-tested on dsh whoisDDD
What it does
DSH approval/question/completion notifier with native browser notifications and toast fallback. / DSH 审批、提问与完成提醒插件，支持浏览器原生通知和 toast 回退。
Works — verified, early-stage project
DSH approval/question/completion notifier with native browser notifications and toast fallback. / DSH 审批、提问与完成提醒插件，支持浏览器原生通知和 toast 回退。 It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
@whoisddd/dsh-approval-notify
English | 中文
A minimal browser-only DSH Web GUI plugin that reminds you when a session needs attention or a background session finishes.
The plugin watches the live DSH session list, prefers native browser notifications, and falls back to a larger stacked toast panel when native notifications are unavailable. On Windows, granted browser notifications surface through the system notification center.
What it notifies
| DSH state | Notification title | Notes |
|---|---|---|
approval |
Approval request | The session is waiting for an approval decision. |
question |
Question request | The session is waiting for a user choice or answer. |
plan-review |
Plan review | The session is waiting for plan confirmation. |
completed |
Completed | A top-level background session has finished. |
completed on a subagent |
Subagent completed | A subagent/background child session has finished. |
Highlights
- Browser-only; the host half is intentionally empty.
- Watches the live DSH session list; no dependency on
dsh-web-ui-all. - Uses native browser notifications first, with
requireInteraction: true. - Falls back to a larger right-bottom toast panel when native notifications fail.
- Supports multiple stacked fallback toasts.
- Deduplicates unchanged attention states so the same pending/completed state does not repeat.
- Labels completed subagents separately from completed top-level sessions.
Install
git clone https://github.com/whoisDDD/dsh-approval-notify.git
cd dsh-approval-notify
pnpm install
pnpm build
dsh plugin --profile web add link:$(pwd)
After installation, reload the DSH Web GUI page. The browser may ask for notification permission on first load. If permission is denied or native notification creation fails, the plugin still shows in-page toast reminders.
Development
pnpm install
pnpm test
pnpm typecheck
pnpm build
Useful scripts:
pnpm test— run all Vitest tests.pnpm test:notify— run the core notification behavior tests.pnpm typecheck— run TypeScript type checking.pnpm build— generatelib/artifacts.pnpm watch— rebuild the client bundle during development.
Notes and limitations
- This plugin does not implement a settings UI yet.
- Notification delivery depends on browser permission and the operating system notification policy.
- Completed-session reminders follow DSH's
completedsummary flag. Top-level sessions and subagents are both notified, but subagents use a distinct title.
License
BSD-3-Clause.
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-approval-notify for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:whoisDDD/dsh-approval-notifyHeadless (CLI) profile:
dsh plugin --profile headless add github:whoisDDD/dsh-approval-notifyTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-approval-notify/)<a href="https://dshbase.com/plugins/dsh-approval-notify/"><img src="https://dshbase.com/badges/dsh-approval-notify.svg" alt="dshbase install-tested"></a>