DSH Status Notifier: Displaying Agent Status in the macOS Menu Bar

DSH Status Notifier is a client plugin bundle for DeepSeek Harness maintained by Carlos5986515. It utilizes SwiftBar to display the agent's real-time status in the macOS menu bar: Pending Permission Approval (orange ⚠), Running Tasks (blue ●), Completed within the last 30 minutes (green ✓), and Idle (gray ○). It refreshes every 5 seconds; clicking it allows listing sessions and reopening the Harness window. Notifications are sent via two distinct channels without duplication: when navigating away from the page, `client.js` of the Web GUI sends a browser notification; when the window is closed but the Host process is still alive, `index.js` uses `osascript` to send a system notification. The plugin observes persistent events such as `approval/asked` and `approval/decided`, as well as `agent/status` state transitions, and generates `dsh-status.5s.sh`, placing the status file outside the plugin directory. It requires macOS, SwiftBar, and a DSH that supports bundles. Installation can be done via local directory + Plugin Manager or `install_bundle`; the SwiftBar directory can be specified via `DSH_SWIFTBAR_DIR`, `~/.dsh/swiftbar-dir.txt`, or `~/.swiftbar`. To verify changes to the rendering logic, use `node test-render.mjs`. This article documents the installation steps, configuration options, and limitations (SwiftBar must be running first, deep linking to specific sessions is not currently supported), and reminds users to review the source code and MIT license before installation.

Read More