Back to directory

dsh-session-notification

In a curated listMaintenance: Active

dingyi222666/dsh-session-notification

Notifications for four session states, with browser alerts and prompts.

View on GitHub
$ dsh plugin --profile web add @dingyi222666/dsh-session-notification

34

stars

2

forks

TypeScript

Language

2026-08-12

Created

2026-11-11

Last push

Install it in the DSH web profile to configure sound and browser alerts for four documented session states.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-09-21

License

Not specified by the author

01What can it help you accomplish?

  • Receive a heads-up when a DeepSeek Harness web session finishes, fails, asks a question, or requests permission.

    Sound alerts and, away from the tab, system notifications for four documented session states.

    People using the dsh web GUI who need to notice session state changes.

02How to install into DeepSeek Harness

Prerequisites

  • dsh 0.1.6-alpha.1 or later.

Installation steps

  1. 01

    Run `dsh plugin --profile web add @dingyi222666/dsh-session-notification`.

    $ dsh plugin --profile web add @dingyi222666/dsh-session-notification

  2. 02

    Restart with `dsh web`.

    $ dsh web

Verify the integration

  • After browser permission is granted, use Test notification to verify the OS notification channel.

03DSH integration and capability boundaries

DSH integrationNative runtime

A notification plugin for the dsh web GUI, installed into the web profile without host changes.

  • Four configurable session-state alerts

    Completed, failed, question-requested, and approval-requested session events.→An independently enabled or disabled alert for each state, using built-in sounds or mute.

  • Custom audio per notification kind

    An mp3, ogg, or wav file up to 1 MB selected for a notification row.→The selected custom audio replaces that kind's built-in sound and can be replaced or removed.

    Custom audio files are stored browser-locally and are not shared preferences.
  • Browser-notification scope and quiet current session

    Browser permission plus a choice of all sessions, main only, or main after subagents.→System notifications for background or other-session events, with an opt-in current-session alert.

    Turning browser notifications on asks for browser permission first.

04Who is it for? When not to use it?

Good for

  • People using the dsh web GUI who need to notice session state changes.

Not for

  • Browser notifications require permission, and sound playback requires page user activation under browser autoplay policy.
  • A session that has never been opened can notify as completed even when it failed, because failure detection uses client-maintained conversation snapshots.

05Compatibility, maintenance and safety notes

  • Browser notifications require permission, and sound playback requires page user activation under browser autoplay policy.
  • Custom audio stored in browser localStorage does not follow the user across browsers or profiles.
  • A session that has never been opened can notify as completed even when it failed, because failure detection uses client-maintained conversation snapshots.
Not specified by the authorNot specified by the authorNot specified by the author

README-backed draft; no safety audit is asserted.

06Frequently asked questions

Which DSH session events can trigger an alert?

The README documents Session completed, Session failed, Question asked, and Permission requested notification kinds.

How do I install dsh-session-notification?

With dsh 0.1.6-alpha.1 or later, run `dsh plugin --profile web add @dingyi222666/dsh-session-notification`, then restart with `dsh web`.

Will DSH alert me about the session currently open in the browser?

Not by default. The current session stays quiet unless you enable Alert for the current session.

Can I use my own sound for a DSH notification?

Yes. Each kind accepts an mp3, ogg, or wav file up to 1 MB; the file is stored browser-locally and does not follow you across browsers or profiles.

08Data and sources

github.com64ab5a8Not specified by the author
  • Author-claimedgithub.com64ab5a8c16d9…

    A notification plugin for the dsh web GUI.

  • Author-claimedgithub.com64ab5a8c16d9…

    Everything lives in this plugin — no harness (host) changes:

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.