DSH Status Notifier
A DeepSeek Harness (DSH) bundle that puts your agent's live
status in the macOS menu bar — so you can see pending approvals and finished tasks without switching back to the
Harness window.
What it shows
| Menu bar | Meaning |
|---|
⚠ 1 (orange) | A permission request is waiting for your approval |
● 1 (blue) | A task is running |
✓ 1 (green) | A task finished less than 30 minutes ago |
○ 空闲 (gray) | Idle |
Clicking the item opens a dropdown listing the sessions behind each state; any row (or the "打开 DeepSeek Harness"
row) brings the Harness window back. It refreshes every 5 seconds.
It also fires macOS system notifications while the page is away (window hidden or unfocused), and through
osascript when the window is closed but the Host keeps running — so a long task can finish while you are in
another app and you still get told. The two notification paths never double-alert: the Host only notifies when no
page is connected.
How it works
Two halves, one bundle:
- Host half (
index.js) runs in the DSH Host process:
- observes durable, order-independent signals —
session/event with approval/asked / approval/decided
(the approval audit pair appended by the Approval service) and agent/status running↔idle transitions;
- renders a SwiftBar script (
dsh-status.5s.sh) plus its output into the plugin folder; the rendered state
files live outside the plugin folder, so SwiftBar never mistakes them for plugins;
- falls back to
osascript notifications when no page is connected.
- Client half (
client.js) runs in the Web GUI: watches the framework's own uiSession.sessionStatus
(running / pendingInteraction / completionUnread) and fires browser notifications when the window is away.
Requirements
- macOS with SwiftBar (
brew install --cask swiftbar)
- DeepSeek Harness with plugin bundle support
Installation
- Clone this repository anywhere, or copy the folder into your workspace.
- Install the bundle in DSH — Plugin Manager → install local bundle, or ask your agent to run
plugin_manager
install_bundle with this directory as the target.
- Make SwiftBar watch the folder:
- create
~/.swiftbar and point SwiftBar's Preferences → General → Plugin Folder at it, or
- keep SwiftBar's own folder and write its path into the first line of
~/.dsh/swiftbar-dir.txt.
- Restart DeepSeek Harness so the Host half loads. The menu bar item appears within a few seconds.
Configuration
| Variable / file | Purpose |
|---|
DSH_SWIFTBAR_DIR | SwiftBar plugin folder (else ~/.dsh/swiftbar-dir.txt, else ~/.swiftbar) |
~/.dsh/swiftbar-dir.txt | First line: the plugin folder path |
DSH_SWIFTBAR_STATE_DIR | Where rendered state files go (default ~/.dsh/swiftbar-state) |
Development
test-render.mjs runs the Host half against a stubbed Cordis context, simulates approval / running / idle
events, and checks the rendered SwiftBar output and the legacy-file cleanup:
node test-render.mjs
Notes and limits
- The menu bar item is a SwiftBar script: SwiftBar must be running for the item to appear.
- Clicking a row brings the Harness window back; deep-linking straight into a specific session is not supported
yet.
- State directories are resolved when the plugin loads; after changing them, restart DeepSeek Harness.
License
MIT — see LICENSE.
