MIT-licensed DSH plugin that puts an always-on-top notch on Windows 10/11 showing which DeepSeek Harness session is working, which needs you, and which is done or failed — with an Open button that jumps straight to that session.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-11-15
License
MIT
01What can it help you accomplish?
See at a glance which DeepSeek Harness session is waiting on you while you work in another window
An always-on-top tab on the screen's top edge that grows into an alert naming the reason when a session needs you, fails or finishes, with an Open button that switches the app to that session
People running several DSH sessions who lose the thing they were doing every time they alt-tab to read each sidebar
Read every session's state, context usage and current step from one folding board instead of switching windows
A board with the most recently changed session on the big bot (title, project, age, context usage, running tool or full question) and the other sessions in a scrolling list
Users who keep the harness minimized or in the tray and want the whole picture without bringing the app forward
Hear about a finished or failed session without watching the app
A few-second alert for a fresh needs-you, failed or finished event, and a tab that goes grey with the last heartbeat date when the host stops answering
Developers who leave long agent turns running and want to be interrupted only when something changes
02How to install into DeepSeek Harness
Prerequisites
- Windows 10/11 x64 — the window is WPF and Win32; there is no macOS or Linux build
- DeepSeek Harness — the plugin was built and verified on 0.2.1-rc.2
- Node ≥ 22 for the plugin (no .NET runtime: the released window is self-contained)
- Optional: the `session-finished` plugin, which is what retires a finished row
Installation steps
- 01
Run `dsh plugin --profile web add dsh-agents-notch`; if the harness runs under another profile, put that profile's name in place of `web`
$ dsh plugin --profile web add dsh-agents-notch
- 02
Let the first run fetch the window: it downloads one 65 MB file from this repo's GitHub release and checks it against the published SHA-256
Verify the integration
- If no notch appears, read the last line of `$DSH_HOME\state\agents-notch\host-report.jsonl` — it says where the host looked for the window, whether the download worked, and the command that fixes it
Rollback
- Remove the plugin with `dsh plugin --profile web remove dsh-agents-notch`
- Delete the state folder: `Remove-Item -Recurse "$env:DSH_HOME\state\agents-notch"` removes the state file, logs, window binary and unpack cache
03DSH integration and capability boundaries
Native DSH plugin added with the `dsh plugin` CLI: a host half reads DSH session events and an in-app half drives a separate always-on-top WPF window
Always-on-top session notch
the DSH sessions the plugin's host half reports: working, needs you, done, failed→one bot per session on a topmost tab — slow blue arc while working, amber when it needs you, green done, red failed
never takes focus; a pointer passing over the tab turns it into a ghost and clicks go through to the window underneathhides under a full-screen appUnfoldable board
the pointer resting on the tab for 1.6 s, or pushed against the top edge of the screen→the most recently changed session on the big bot (title, project, age, context usage, running tool or full question) plus a scrolling list of every other session
clicking a row puts that session on the big bot; double-clicking a row or pressing Open ↗ switches DeepSeek Harness to itAlerts with an Open button
a fresh needs-you, failed or finished session event→a few-second alert grown out of the tab, with the reason (or the last tool and the session title) and an Open button
only fresh events are announced; older questions stay on the boardIts own Settings pane and YAML config rows
Settings → Agents Notch, or a row with the same id in `$DSH_HOME/profiles/web/cordis.patch.yml`→size, anchor, screen, row count, opacity, motion, pointer behaviour, alert type and `contextBudget`, applied on the next tick without a restart
a value written by the pane into `$DSH_HOME/state/agents-notch/settings.json` beats the profile's `config:` rowFirst-run window install with hash check
the first plugin run while `autoDownload` is `true`→a self-contained WPF window binary in the state dir, checked against the published SHA-256
downloads one 65 MB file from this repo's GitHub release, so the first run needs network access`autoDownload: false` turns the download off and `downloadUrl` points it at a mirror or a hand-built window
04Who is it for? When not to use it?
Good for
- People running several DSH sessions who lose the thing they were doing every time they alt-tab to read each sidebar
- Users who keep the harness minimized or in the tray and want the whole picture without bringing the app forward
- Developers who leave long agent turns running and want to be interrupted only when something changes
Not for
- Windows only: the window is WPF and Win32 (topmost, no-activate, fullscreen detection) and package.json declares "os": ["win32"]. There is no macOS or Linux build, and no partial one.
- No DSH version is declared in the manifest, so nothing gates a wrong install: it was built and verified on 0.2.1-rc.2, the host half reads session/event, ctx.webServer, ctx.agents and sessionQuery, and nothing is checked before mounting.
- The downloaded window binary is unsigned, so Windows SmartScreen warns the first time it is run. It comes from this repo's GitHub release and is checked against the published SHA-256; `autoDownload: false` plus `tools/install-window.ps1` installs a window by hand instead.
05Compatibility, maintenance and safety notes
- Windows only: the window is WPF and Win32 (topmost, no-activate, fullscreen detection) and package.json declares "os": ["win32"]. There is no macOS or Linux build, and no partial one.
- No DSH version is declared in the manifest, so nothing gates a wrong install: it was built and verified on 0.2.1-rc.2, the host half reads session/event, ctx.webServer, ctx.agents and sessionQuery, and nothing is checked before mounting.
- The downloaded window binary is unsigned, so Windows SmartScreen warns the first time it is run. It comes from this repo's GitHub release and is checked against the published SHA-256; `autoDownload: false` plus `tools/install-window.ps1` installs a window by hand instead.
MIT · latest release v0.2.1 (2026-11-10)
06Frequently asked questions
How do I install Agents Notch in DSH?
Run `dsh plugin --profile web add dsh-agents-notch`; if the harness runs under another profile, put that profile's name in place of `web`. The plugin is ~30 KB, and its first run downloads the window (one 65 MB file) from this repo's GitHub release and checks it against the published SHA-256.
Does it work on macOS or Linux?
No. The window is WPF and Win32 (topmost, no-activate, fullscreen detection) and `package.json` declares `"os": ["win32"]`. The README states plainly that there is no macOS or Linux build, and no partial one.
Which DSH version does it need?
No DSH version is declared in the manifest, so a wrong install is not gated. It was built and verified on 0.2.1-rc.2: the host half reads session/event, ctx.webServer, ctx.agents and sessionQuery, the in-app half uses uiWorkspace, and an older build may lack one of them. Nothing is checked before mounting, so a missing field shows up in the log instead of taking the host down.
Why can't I see a context percentage?
The context window belongs to the model route and the session feed does not carry it, so `contextBudget` defaults to `null` — you get a token count and no percentage, no bar and no amber. Set it to your route's real window (this build's DeepSeek V4 routes: `1000000`) and the percentage and the bar appear.
What does it change in a DSH session, and what leaves the machine?
The notch never takes focus, hides under a full-screen app, and only announces fresh events. Its state file, logs and window binary live under `$DSH_HOME/state/agents-notch`; the only network step the README describes is the first-run download of the window from this repo's GitHub release, verified against the published SHA-256, and it can be turned off with `autoDownload: false`. Open needs the app's own window, so DeepSeek Harness has to be running — the notch can pull its window back from the taskbar or the tray, but it cannot start the app.
07Related DSH workflows
ds-harness-remote
by liguobao
Lets authorized desktop, web, and Android clients operate a remote Harness host.
dsh-windows-mcp
by hellohub1212
Windows desktop automation for DeepSeek Harness: the in-box MCP client bridge mounted against CursorTouch/Windows-MCP, with an off-by-default Computer Use switch and an in-app dependency installer.
dsh-desktop
by anywhere-labs
Modern desktop client for the DeepSeek Harness (dsh) plugin ecosystem. Everything is a plugin — even the desktop shell itself.
dsh-go
by ccch1mneyyy
Run DeepSeek Harness on your phone and remotely control your desktop from a native Android app.
08Data and sources
**An always-on-top notch for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) that answers one quest…
dsh plugin --profile web add dsh-agents-notch
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-15. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
