AI Agent Hub
Back to plugins
🖥️

dsh-plugin-notifications

Client Updated 2026.08.25

Run the following command in DeepSeek Harness:

dsh plugin install NattoCB/dsh-plugin-notifications

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

Install the plugin by running dsh plugin install NattoCB/dsh-plugin-notifications in the DeepSeek Harness terminal; the source repository is at https://github.com/NattoCB/dsh-plugin-notifications

About this plugin

When you run an agent through the DSH Web GUI, switching to another window to keep working means losing all visibility into whether the turn has finished. dsh-plugin-notifications closes that gap with a single, focused job: when any root session (subagent and automation runs are skipped) completes a turn, the host process fires a native macOS notification titled with the session name and bodyed with the latest assistant reply, auto-truncated. The alert arrives even after the GUI is closed or minimized.

Beyond the banner, an optional chime is synthesized in-process as a 16-bit PCM mono WAV at 44.1 kHz with a 20 ms linear attack and exponential decay, then played through terminal-notifier. Three tonal profiles (soft, crisp, low) use the exact same waveform parameters as the in-card Web Audio preview, so what you hear in settings is what you hear in notification and there are no asset files to ship, fully offline. The bilingual settings card renders into the Settings General slot with toggles for enabling notifications, sound, tone selection, and a preview button; all state is persisted to the notifications namespace in settings.yaml.

It is built for macOS developers who juggle a terminal, a browser, and DSH in parallel: stay in flow on your current task, and when the round ends a quiet nudge or a soft chime naturally pulls your attention back.

Use Cases

  • Switch to the terminal to keep coding while the agent finishes its turn, then a macOS notification pops up
  • The GUI is closed but the agent completes a turn in the background and you still get the alert
  • Enable the chime and know a round is done without even glancing at the screen

Best For

  • macOS developers who juggle a terminal, a browser, and DSH in parallel
  • Remote workers who want to stay in flow and only get pulled back when a turn ends
  • Users running multi-turn agent tasks in the background and confirming results round by round