YuMo226/dsh-task-notify

Native Windows system notification (Notification Center toast) when a task completes: goal completion or agent turn end.

Bundle verified MIT JavaScript Unknown
Bundle verified

Listed

0

Notify

Bundle verified

★ 0 View on GitHub
VersionUnknown
LanguageJavaScript
LicenseMIT
View on GitHub

Preview

Preview 1 of 2: YuMo226/dsh-task-notify
Preview 2 of 2: YuMo226/dsh-task-notify

What it does

Native Windows system notification (Notification Center toast) when a task completes: goal completion or agent turn end.

Best for

  • Windows users who want a native Notification Center toast when a goal completes or an agent turn ends.
  • Users who run long DSH tasks in the background and need an OS-level completion signal.
  • Workflows that need configurable completion triggers and a minimum interval between notifications.

Not ideal for

  • Foreground workflows where the user already watches task completion and system notifications add little value.
  • Windows systems with Notification Center disabled or Focus Assist suppressing ordinary notifications.
  • Workflows requiring every rapid completion event to produce a toast, because notifications are rate-limited.

README

dsh-task-notify

English 中文

A DeepSeek Harness (DSH) plugin that shows a native OS system notification whenever a task completes — goal completion or agent turn end. Windows / macOS / Linux.

Features

  • Native OS notifications on every platform: Windows toast, macOS Notification Center, Linux libnotify — real system banners, not blocking dialogs.
  • Two “task done” triggers (configurable):
    • goal completes (phase = complete)
    • an agent turn ends normally
  • Zero runtime dependencies — Node built-ins + OS-native commands (PowerShell, osascript, notify-send).
  • CJK-safe — Windows text travels via UTF-8 temp files so Chinese/Japanese/Korean content is never corrupted.
  • Anti-spam rate-limit between notifications.

Platform support

OS Mechanism Requires
Windows WinRT toast (Notification Center) nothing (AUMID registered at runtime)
macOS osascript display notification macOS 10.8+
Linux notify-send (libnotify) libnotify (notify-send); falls back to zenity, then kdialog

How it works (Windows)

  1. On first notify, the plugin registers an AppUserModelID (dsh.tasknotify) under HKCU\Software\Classes\AppUserModelId so CreateToastNotifier can deliver to the interactive desktop.
  2. When a task completes, it writes the title/body to UTF-8 temp files and runs a small PowerShell script that shows a WinRT ToastText02 notification via ToastNotificationManager.
  3. Temp files are removed afterwards. Failures are logged (never thrown) so they never break an agent turn.

Each notification (and any failure) is recorded in an audit log at <home>/task-notify.log.

Install

As a dsh bundle, installable via the profile plugin manager:

dsh plugin --profile web add dsh-task-notify

Or install the repo directly (npm alias spec):

dsh plugin --profile web add github:YuMo226/dsh-task-notify
Manual install (no pnpm)

Copy this package into the profile’s hoisted node_modules and add a loader entry:

- insert:
    - id: notify
      name: dsh-task-notify
      config:
        onGoalComplete: true
        onTurnEnd: true
        title: 'DeepSeek Harness'
        minIntervalMs: 4000

Restart dsh web after installing for the plugin to mount.

Configuration

Key Type Default Description
onGoalComplete boolean true Notify when a goal completes.
onTurnEnd boolean true Notify when an agent turn ends normally.
title string DeepSeek Harness Leading line of the notification.
minIntervalMs number 4000 Minimum ms between two notifications (anti-spam).

Troubleshooting

  • Windows: make sure the notification center is on and Focus Assist is not set to “Alarms only” / “Priority only”.
  • Linux: install libnotify (provides notify-send); if missing, the plugin falls back to zenity, then kdialog.
  • If no notification appears, check <home>/task-notify.log for an error line and open an issue.

License

MIT

Frequently Asked QuestionsFAQ

Use the verified command dsh plugin --profile default add github:YuMo226/dsh-task-notify in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.

alvinunreal/openpets#dsh★ 1,074

Bridges DeepSeek Harness lifecycle status, errors, and approval requests to a locally running OpenPets desktop companion.

MIT
dsh-market/dsh-market★ 909

(Recommended) The plugin market inside DSH: a Settings page to browse and search the full community catalog by category, with confirmed one-click installs and an installed-plugins view.

MIT
bradeGithub/DSH-Plugins-Marketplace★ 119

GitHub-topic-driven plugin & skill marketplace: a Settings page that browses the auto-collected registry (the whole dsh-plugin topic plus the skills index, CI-refreshed every 2 hours) with one-click install, type detection, install-script and host-shadow-dependency safety confirmations, env-key management, and the STANDARD.md recognition spec.

MIT
shaobeichen/dsh-pocket★ 97

Remote phone access to the DSH Web UI: scan a QR code for LAN or public (cloudflared tunnel) access with real-time sync, a mobile-adaptive layout, and a settings tab.

GPL-2.0