AI Agent Hub
Back to plugins
🖥️

proactive-notify

Client Updated 2026.08.22

Run the following command in DeepSeek Harness:

dsh plugin install DemoJ/proactive-notify

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install DemoJ/proactive-notify in your terminal to install the proactive-notify plugin from https://github.com/DemoJ/proactive-notify, then restart dsh web to activate it.

About this plugin

Running an Agent through DSH means you almost certainly are not staring at that tab the whole time. A tool waits for approval, gets blocked by a sandbox rule, or quietly finishes a turn, and by the time you switch back the approval window has already timed out or the issue went stale. proactive-notify bridges that gap by pushing critical events as browser system-level notifications: an entry appears in your OS notification center with a built-in sound, no matter which application you are currently in.

The plugin handles three scenarios: a tool is waiting for your approval, a tool execution is denied by a permission or sandbox rule, or the Agent has finished its current turn and gone idle. The approval notification in particular has a clever timing layer. It holds back until the approval panel is actually rendered in the page DOM, so the moment you switch back the buttons are already there. If the WebSocket never connects, a forced fallback fires after three seconds so the alert is never lost. When notifications are working properly the page shows zero UI clutter; only when permission is still ungranted does a small guide card appear in the corner, one click to authorize, then silence.

This is built for one clear use case: you run Agents semi-automatically in the DSH Web GUI while juggling other work in different applications, and you do not want to keep tab-switching just to check whether anything happened. Once installed, the plugin loads permanently with the DSH process. No extra desktop client, no repeated setup. All you need is Chrome, Edge, or Firefox with the DSH tab kept open in the background.

Use Cases

  • You are in another app when the Agent pauses for tool approval — a system notification pulls your attention back instantly
  • A tool call is denied by a sandbox or permission rule — an alert fires immediately so the stall is never silent
  • The Agent finishes its turn and goes idle — a completion notification tells you the job is done without tab-hopping

Best For

  • Users who run semi-automated Agent sessions in DSH Web GUI while working in other applications
  • Developers who want cross-app visibility into approvals and task status without installing a separate desktop client
  • Users who prefer zero in-page UI clutter and rely solely on OS-level notifications for Agent state updates