Foreword

When running agent tasks in DeepSeek Harness (DSH), it is common to switch to other windows to write code or check documentation while DSH continues to run in the background. At the end of a task, there is no obvious signal, and when it requires you to click “approve” for a tool call, it does not proactively notify you. Products like Codex or WorkBuddy will issue system-level alerts to bring your attention back to the conversation. DSH itself does not have built-in cross-window notifications. The community plugin dsh-reminder (maintained by Aisland-SJL) fills this gap: it pops up reminders in any window when a task is completed or awaiting approval, allowing you to click to return to the corresponding session.

What is This

dsh-reminder is a cross-window reminder plugin for the DSH web interface, categorized under “workflow”. It uses the browser’s Notification API to display a card in the bottom-right corner and play a short, gentle sound when a task turn ends or a tool call is awaiting approval. It only reminds and does not approve on your behalf. The plugin is released under the MIT license, currently at version 0.1.0, and has approximately 12 stars on GitHub (as of the time of data collection).

Architecturally, a single npm package includes both the host (a Cordis plugin that registers settings namespace and Typert Remote) and the client (subscribes to session list and conversation snapshots, listening for mux stream events like turn/end and approval/requested). The plugin is designed to be read-only and does not modify DSH’s core behavior.

Core Features

The verified capabilities are described below by event type.

Task Completion Reminder

At the end of each conversation turn, a green “Task completed” notification pops up, displaying session information and elapsed time, with a green checkmark icon.

Approval Waiting Reminder

When a tool call is awaiting approval, an amber “Waiting for your approval” notification pops up, displaying the tool name and a warning icon.

Cross-Window and Interaction

  • It will pop up even when working in other application windows, not limited to when the DSH tab is in the foreground.
  • Clicking the notification focuses the DSH window and opens the corresponding session.
  • The notification automatically disappears after 3–5 seconds (duration adjustable).
  • It plays a soft two-tone sound (D4→A4); deduplicates for the same event to avoid repeated pop-ups.
  • The plugin does not click “approve” on behalf of the user.

Settings

Configurable in DSH Settings → Reminders:

Setting Default Description
Notification permission Not set One-click authorization and sends a test popup
Approval reminders Enabled Disables approval reminders when turned off
Completion reminders Enabled Disables completion reminders when turned off
Duration 3–5 s Seconds before auto-dismiss
Failure alerts Disabled (reserved) Planned for v0.3

Installation and Activation

First install the plugin, then register it in the web configuration and restart the process.

1. Install the Plugin

Install via DSH CLI (web profile):

dsh plugin --profile web add <dsh-reminder>

Or use npm:

npm i dsh-reminder

2. Register and Restart

Register dsh-reminder in the profile’s bundle list, then restart the DSH web process to activate the host and client.

Typical Usage

After installation and restart, follow the steps below for authorization and verification.

  1. Open DSH Settings → Reminders.
  2. Click Enable & test notifications, and select “Allow” in the browser permission dialog; you should immediately receive a test popup.
  3. Switch to another window and continue working. When the agent completes a turn or awaits your approval for a tool call, the corresponding notification will pop up in the bottom-right corner; click it to return to the session.

Note: Sound playback is restricted by the browser’s autoplay policy. A click on the page is required first to unlock it.

Applicable Scenarios and Notes

Who is it for: Developers who often let DSH run tasks in the background for long periods and frequently switch windows; users who need to respond promptly to tool approvals without manually switching back to the DSH tab repeatedly.

Usage Notes:

  • Notification permissions must be triggered by a user gesture (browser policy); the test button in the settings page is designed for this.
  • Chrome page notifications do not support actions buttons; they can only be closed via auto-dismiss or hover. Persistent notifications with actions require a Service Worker, which this plugin does not use.
  • Failure alerts are currently reserved and disabled by default.
  • The plugin runs with the current DSH process permissions. Before installation, please read the GitHub source code and MIT license to ensure it meets your security and compliance requirements.

The community directory SkillHub is an independent site with no official affiliation to DeepSeek or幻方; plugin information is based on the repository’s README.

Conclusion

dsh-reminder implements cross-window reminders for “task completed” and “awaiting approval” events, allowing you to click to return to the session. Its changes are limited to the notification layer and do not touch DSH’s core logic. If you are already using DSH’s web interface and wish to reduce the frequency of “switching back to check”, you can install and try it following the steps above.