dsh-reminder

peon-ping sound notifications for DeepSeek Harness (dsh) — a faithful port of the pi plugin pi-peon-ping-win.

Plays themed audio clips (Warcraft III Peon, GLaDOS, Duke Nukem, StarCraft, …) on lifecycle events using OpenPeon sound packs, and shows desktop notifications — with native Windows support (three-tier audio fallback ffplay → mpv → winmm.dll PlaySound, custom WinForms popup).

Acknowledgments

This project is a port, not an original work. All credit for the underlying functionality goes to:

• pi-peon-ping by Josh Thomas — the original peon-ping extension for the pi coding agent.
• pi-peon-ping-win by cppgohan — the fork that added native Windows support (audio fallback, WinForms popup, event-aware notifications).
• peon-ping and the OpenPeon sound packs / registry.

Thank you to all of them for the original work and the MIT license that makes this port possible.

Features

dsh port default: the harness stays quiet — only a task completing or terminating unexpectedly beeps. Everything else (session start, per-prompt ack, spam, individual tool errors, compaction) is off by default and can be re-enabled with /peon toggle <category> (tool errors with /peon tool-error on).

This is the same feature table as the pi plugin; only the host and the default on/off set changed. The event mapping:

Requirements

• DeepSeek Harness (any profile — the plugin is installed as a profile bundle)
• An audio player on your system (see Platform support below). On Windows, winget install Gyan.FFmpeg for the best experience.

Installation (npm)

Install as a profile plugin:

dsh plugin --profile web add dsh-reminder

Restart the harness (or reload the profile) so the new bundle layer mounts. The bundle patch (cordis.patch.yml) inserts the peon-ping plugin row automatically — no manual cordis.patch.yml editing.

To install from a local checkout:

dsh plugin --profile web add D:/1codeprojects/dsh-plugins/dsh-reminder

To uninstall:

dsh plugin --profile web remove dsh-reminder

Usage

All settings live in the web Settings page: open Settings (the gear icon in the sidebar), scroll past Agent Presets to the peon-ping sounds section. There you can:

• see the current state (pack, volume, toggles, relay mode) and the host notice line,
• Install default packs (downloads the 10 default packs from the peon-ping registry),
• pick the active sound pack from the installed ones,
• set the volume,
• toggle desktop notifications, the tool-error beep, and every sound category,
• pause/resume sounds, set the silent window and relay mode,
• Preview the current pack's session-start sound.

Changes are written through to ~/.config/peon-ping/config.json immediately, so they apply to the next event without a restart. There is no /peon slash command — the pi TUI panel became this web page.

Settings-page transport: the page talks to the host through the plugin's own /peon/api HTTP route (same origin, behind the browser-trust fence), not through the host's settings-namespace allowlist (dsh-host-apiproxy's WEB_SETTINGS_NAMESPACES admits only built-in namespaces; a third-party namespace is filtered from settings.describe even when registered). So the settings page works on dsh versions that never added peon-ping to that allowlist.

To install specific packs from the registry directly, edit ~/.config/peon-ping/config.json or use the registry's pack names with the page's install action (the page installs the defaults; pack names come from the peon-ping registry).

Platform support

WSL audio works out of the box on any distro: the \\wsl.localhost\<distro>\... prefix, the user name, and the /mnt/<drive> mounts are resolved dynamically by wslpath -w per machine — nothing is hardcoded.

Config and data

Config, state, and packs live in the same files the pi plugin uses, so a machine that already ran pi-peon-ping keeps its packs and settings:

• ~/.config/peon-ping/config.json
• ~/.config/peon-ping/state.json
• ~/.config/peon-ping/packs/

Legacy config with active_pack is migrated to default_pack on load. Packs are also picked up from ~/.claude/hooks/peon-ping/packs (Claude Code).

Remote development

The extension auto-detects SSH sessions, devcontainers, and Codespaces, and routes audio through the peon-ping relay running on your local machine (see the peon-ping remote development docs). Configure with /peon relay.

Development

The repository is self-contained: all type declarations come from the npm devDependencies (no vendored or machine-specific paths in tsconfig.json).

npm install
npm test              # run tests
npm run typecheck     # type check
npm run build         # build lib/ (host bundle)
npm run build:client  # build lib/client.js (browser bundle)
npm run publish:dry-run  # verify the npm package contents

License

MIT. All credit for the original work goes to joshuadavidthomas (pi-peon-ping) and cppgohan (pi-peon-ping-win, native Windows support).