dsh-win-notify

A DeepSeek Harness (dsh) plugin that shows a Windows toast notification with sound when an agent task finishes.

• App name DeepSeek with the official whale icon in the notification
• Notifies when an agent turn completes (running → idle)
• Shows the last user prompt in the notification body
• Also notifies on task errors (configurable)
• Also notifies when an agent is waiting for user approval (sandbox escalation etc.), after a configurable delay — quickly auto-decided requests stay quiet
• Tasks you manually stop are not treated as completed — no notification
• Pure PowerShell 5.1 (built into Windows) — no extra dependencies

Requirements

• Windows 10/11
• dsh (DeepSeek Harness) — any profile (web, headless, tui)

Install

dsh plugin --profile web add github:MuziIsabel/dsh-win-notify

dsh plugin forwards to pnpm inside the profile directory; the bundle reconciles itself into the profile's dsh.profile.bundles list. Restart (or let the profile's HMR apply) the profile for the row to activate.

The plugin works in any profile — add it to headless/other profiles the same way if you want notifications there too.

Uninstall

dsh plugin --profile web remove dsh-win-notify

Configuration

The bundle inserts a loader row win-notify into the profile. Override its config in the profile's cordis.patch.yml:

- id: win-notify
  config:
    enabled: true          # enable the plugin (default true)
    sound: default         # default | reminder | sms | alarm | silent
    onError: true          # also notify on task errors (default true)
    title: 'DeepSeek Harness'
    body: '任务已完成'
    bodyError: '任务出错'
    maxPromptChars: 64
    approval: true         # notify when waiting for user approval (default true)
    approvalWaitMs: 3000   # notify only if still undecided after this delay (ms)
    bodyApproval: '等待用户审批'
    maxReasonChars: 80     # max length of the approval reason shown

How it works

1. Identity registration (one-time, automatic). Windows only displays toasts from registered app identities. On activation the plugin:
   • compiles a tiny stub into ;