Plugin directory / Developer / dsh-turn-reminder
dsh-turn-reminder
Verified · install-tested on dsh SipengXie2024
What it does
User-attention notifications for DeepSeek Harness (dsh) web: turn end, approval requests, and model questions — in-page toast + OS-level browser notification
Works — verified, early-stage project
User-attention notifications for DeepSeek Harness (dsh) web: turn end, approval requests, and model questions — in-page toast + OS-level browser notification 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
dsh-turn-reminder
User-attention notifications for DeepSeek Harness (dsh) web. Whenever a session blocks waiting for you, this plugin reminds you: an in-page toast while the page is visible, an OS-level browser notification while the page is hidden (click it to jump back; falls back to the toast when the system channel is unavailable).
What it watches
| Channel | Trigger | Notes |
|---|---|---|
turnEnd |
agent/status event, running → idle |
A turn finished and the session waits for input. Blocked goals and errored turns end the turn, so they are covered transitively. |
approval |
approval/request waterfall (pass-through listener) |
Tool approvals, sandbox escalations, etc. These block mid-turn — the agent never goes idle, so a turn-end watcher alone misses them. |
question |
tools/pre-execute waterfall, filtered on ask_user_question (pass-through listener) |
The model asks you a question; also blocks mid-turn. |
plan |
tools/pre-execute waterfall, filtered on exit_plan_mode (pass-through listener) |
The model presents a plan for review. The review panel opens inside the tool call, so this also blocks mid-turn — earlier versions wrongly assumed turnEnd covered it. |
Notification bodies carry detail: approvals show the tool name plus the asker's reason, questions show the first question's text, plan reviews show the plan's first markdown heading (all clipped at 60 chars). Counters are per session, so multiple tabs each remind only about their own session.
Usage
A 🔔 control sits at the right end of the composer tool row. Click it once to grant the browser Notification permission (browsers require a user gesture; the permission persists per origin). The in-page toast dismisses itself after 8 seconds, or on click.
Build & install
npm install
npm run build # tsc (host half) + tsdown (client closure-factory bundle)
npm pack # produces dsh-turn-reminder-0.1.0.tgz
dsh plugin --profile web add dsh-turn-reminder-0.1.0.tgz
Then restart dsh web — bundle plugin rows load at boot. After that it serves every session automatically.
How it works
- Host half (bundle layer): listens to
agent/status/approval/request/tools/pre-execute(ask_user_questionandexit_plan_mode) across all agents, keeps per-session counters per channel, and exposes them through a Typert Remote serviceturnReminder/poll(agent-scoped; the wire argumentagentIdis the session id). - Client half: registered into the session-scoped
conversation.input.rightslot, whose standard props carrysessionId— that is how the page knows which session to poll. Polls every 1.5 s; on a counter increment, fires the toast or a systemNotification(per-channel tags so different kinds don't replace each other). - Both waterfall listeners are pass-through (
return next()); they observe, never decide.
Notes
- Counters only cover events after the plugin loaded; they reset on process restart, and the first poll only records a baseline (no catch-up reminders for history).
- Tested against dsh
0.1.0-rc.6. Reinstalling from a local tarball needs a version bump (pnpm dedupes same name+version and keeps the old build).
License
MIT
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-turn-reminder 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:SipengXie2024/dsh-turn-reminderHeadless (CLI) profile:
dsh plugin --profile headless add github:SipengXie2024/dsh-turn-reminderTest 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-turn-reminder/)<a href="https://dshbase.com/plugins/dsh-turn-reminder/"><img src="https://dshbase.com/badges/dsh-turn-reminder.svg" alt="dshbase install-tested"></a>