Introduction

The plugin philosophy of DSH is “everything is a plugin.” When running agents within the DSH Web GUI, events such as task completion, agent inquiries, waiting for approval, or plan review can all occur in the background. If the window is not in the foreground, the lack of system-level notifications makes it easy to miss the opportunity to handle these tasks.

Below is an introduction to dsh-agent-notify. It routes these types of events to the Windows Notification Center, using the browser’s Notification API to display notification bubbles. It does not rely on in-page popups or synthetic audio.

What is it

dsh-agent-notify is a task completion notification plugin for the DSH Web GUI maintained by chidaic, licensed under the MIT license.

It addresses the issue of agent state changes in the Web GUI not being prominent enough:

  • Sends a system notification when an agent completes a task.
  • Sends a system notification when the agent needs the user to answer, approve, or review a plan.
  • Focuses the page and opens the corresponding session when the notification bubble is clicked.

It is a pure browser-side plugin with an empty host half. Settings are stored in the browser’s localStorage.

Core Features

Notification Triggers

The plugin listens for the following state changes:

  • Sends a “Task Completed” system notification when the session changes from running to stopped.
  • Sends a “Needs Your Answer” notification when the agent asks a question (i.e., question).
  • Sends a “Needs Your Approval” or “Please Review Plan” notification when approval or plan-review appears.

Notification Format

Notifications are issued via the browser’s Notification API and appear as bubbles in the Windows Notification Center.

Specific behaviors:

  • Sound is the Windows system notification sound, controlled by Windows settings.
  • No in-page popups.
  • No synthetic audio.
  • No extra UI buttons.
  • Clicking the bubble focuses the page and opens the corresponding session.

Notifications do not include a tag. This is to prevent Chrome on Windows from silently updating notifications with the same tag instead of displaying new bubbles.

Notification Content

Notification content includes:

  • The session title.
  • A 90-character summary of the last assistant reply in that session.

The summary appears only when the session window is already open.

System Notification Modes

The plugin supports three system notification modes:

  • Do Not Send
  • Send While in Background
  • Always Send

The default mode is Always Send.

Authorization Method

There are two authorization methods:

  • Automatically requests notification permission on the first click on the page.
  • Manually authorize in the Task Alerts page of the DSH official settings interface.

Settings Entry

The plugin integrates with the top-level page Task Alerts in the DSH official settings interface. On this page, you can:

  • Enable or disable notifications.
  • Choose whether to include sub-agent notifications.
  • Select the system notification mode.
  • View permission status.
  • Manually authorize.
  • Send a test notification.

Settings are saved in dsh.agentNotify.settings.v3 in localStorage.

Preventing False Positives

The plugin imposes limits on repeated notifications:

  • After page load or reconnection, the first list snapshot serves only as a baseline; historical completion events are not replayed.
  • Completions that occur during reconnection will not be falsely reported after the connection is restored.
  • No duplicate notifications for the same pending status.
  • Sub-agent sessions are not notified by default but can be enabled in settings.

Browser-Side Loading

The plugin is a pure browser-side implementation with an empty host half; no build tools are required.

After changes to the browser-side bundle, simply refresh the page to load the latest client.js. If encountering stale cache, use Ctrl+Shift+R for a hard refresh.

Installation and Enabling

First, install the plugin:

dsh plugin --profile web add dsh-agent-notify

If installing from GitHub, use the following command:

dsh plugin --profile web add github:chidaic/dsh-agent-notify

After completing the steps above, refresh the page to load the plugin.

To enable notifications, perform these two steps first:

  1. On the first click on the page, allow browser notification permission.
  2. Enter the DSH official settings interface → Task Alerts, enable notifications and select the system notification mode.

Typical Usage

Selecting Notification Mode

Enter the DSH official settings interface → Task Alerts and select the system notification mode:

  • Do Not Send: Does not send system notifications.
  • Send While in Background: Sends only when the page is in the background.
  • Always Send: Default mode, always sends system notifications.

Authorization

Authorization can be performed as follows:

  1. On the first click on the page, the browser will ask for notification permission; select Allow.
  2. If permission was previously denied, you can also go to the DSH official settings interface → Task Alerts and manually authorize in the permission status area.

Diagnosing Notifications

If notifications are not appearing, you can use Send Test Notification on the settings page.

It will ignore the current send mode and directly send a system notification, displaying the result.

If it shows as sent but no bubble appears in the Windows Notification Center, check the following:

  • Browser site permissions.
  • Windows system notification switch.
  • Windows notification sound.
  • Windows Focus Assist.

Sub-Agent Notifications

Sub-agent sessions are not notified by default.

If you want sub-agent sessions to also trigger system notifications, you need to enter the DSH official settings interface → Task Alerts and enable “Include Sub-Agent Notifications”.

Updates

After changes to the browser-side bundle, simply refresh the page.

If the page still behaves like the old version, use Ctrl+Shift+R for a hard refresh to avoid old cache affecting your judgment.

Applicable Scenarios and Notes

Suitable for users running agents in the DSH Web GUI who wish to receive system-level alerts when tasks are completed, waiting for answers, or awaiting approval.

Please note the following points:

  • The plugin depends on the browser’s Notification API and Windows system notification settings.
  • Notification effectiveness may be affected by browser site permissions, Windows system notification switch, notification sound, and Focus Assist.
  • Historical completion events will not be replayed after page load or reconnection.
  • Sub-agent sessions are not notified by default.
  • The plugin runs with the permissions of the current dsh process; you should check the source code and MIT license before installing.

Links

GitHub repository:

https://github.com/chidaic/dsh-agent-notify