AI Agent Hub
Back to plugins
🖥️

dsh-macos-notify

Client Updated 2026.08.25

Run the following command in DeepSeek Harness:

dsh plugin install CrombastiC/dsh-macos-notify

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install CrombastiC/dsh-macos-notify inside DeepSeek Harness to install, or pull the latest build directly from https://github.com/CrombastiC/dsh-macos-notify.

About this plugin

Running multiple terminal tasks in DeepSeek Harness means a quick detour to email or a meeting can hide a failed turn or a pending approval. dsh-macos-notify turns those events into native macOS notifications where completion, error, abort, and approval each carry their own system sound, so you stay aware without staring at the screen.

The design centres on fewer interruptions with full traceability. A 1.5-second coalescing window and an optional periodic digest keep parallel tasks from flooding the Notification Center, while daily quiet hours and a temporary pause button let you silence non-critical alerts overnight yet still let errors and approvals break through. Project-path rules let you mute entire repositories, show errors only, or mark important projects that bypass every filter. Duplicate-error suppression with a configurable cooldown ensures the same failure in the same session rings once. Custom sounds can be imported straight from the web settings page in MP3, FLAC, OGG, and other formats, auto-converted to AIFF for in-page preview, capped at 20 files and 50 MB. Every decision--sent, queued, suppressed, or failed--is logged in a diagnostic history that survives restarts.

Built for Mac developers who run long-lived DSH terminal sessions across multiple windows and want reliable heads-up without notification spam. The plugin needs only macOS and Node.js 22+; no extra daemon is required. Install it, tweak toggles and sounds from the web settings page, and you are ready to go.

Use Cases

  • Running parallel Harness tasks and not wanting to miss errors or pending approvals after switching away
  • Enabling quiet hours overnight or during meetings while still receiving critical errors and approvals
  • Muting or error-only alerts per project path to reduce irrelevant notifications

Best For

  • Developers running long-lived DSH terminal sessions on Mac
  • Engineers working across multiple windows who need real-time status awareness
  • Power terminal users who value configurable notifications and sound management