dingyi222666/dsh-session-notification
70Last commit Aug 13, 2026
dsh-session-notification DSH plugin
This plugin integrates with the dsh web settings panel to let you control notifications for four session events: completion, failure, question, and permission request. It plays built-in or custom audio, and can send browser-level system notifications when the tab is not focused.
How to install the dsh-session-notification DSH plugin
dsh plugin --profile web add @dingyi222666/dsh-session-notificationCopying does not run this command. Review the repository and version before installing the dsh-session-notification DSH plugin.
dsh-session-notification DSH plugin data source
dsh-session-notification DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-session-notification DSH plugin can do
- Monitors session completion, failure, question, and permission request events
- Plays one of four built-in synthesized sounds (chime, fault, pop, alert) per event type
- Allows uploading custom audio files (mp3/ogg/wav, up to 1 MB) for each event type
- Controls master volume with a slider and enables/disables sound globally
- Shows browser (system-level) notifications when permission is granted, with event details and final reply text for completed sessions
- Registers a Notifications settings section in the dsh web GUI via the settings.section slot
Where the dsh-session-notification DSH plugin fits
- Get alerted when a long-running session finishes without having to watch the screen
- Receive immediate notification if a session fails with an error
- Be notified when the agent asks a question or requests permission, so you can respond promptly
- Use custom audio files to distinguish event types with your own sounds
- Enable browser notifications to stay informed even when the tab is in the background
Who the dsh-session-notification DSH plugin is for
- dsh web GUI users who want to be notified of session events without constantly checking the UI
- Users running multiple sessions who need to prioritize responses to failed or pending sessions
dsh-session-notification DSH plugin limitations
- Failure detection relies on the conversation snapshot, so sessions that are never opened may incorrectly report as completed even if they failed
- Browser notifications require user permission, and sound playback needs a user activation gesture due to autoplay policy
- Custom audio files are stored in browser localStorage and do not sync across different browsers or devices
- The plugin observes the sessions list snapshot and may miss a run that starts and finishes between two snapshots (though this is unlikely in practice)
dsh-session-notification DSH plugin: from the repository README
Quoted from the dingyi222666/dsh-session-notification README, the upstream source of the dsh-session-notification DSH plugin. Copyright remains with the original authors.
English | [中文](README.zh.md) A notification plugin for the dsh web GUI. When a session finishes, hits an error, asks you a question, or needs your permission, you get a heads-up: a sound plays, and when you step away from the tab a system notification keeps you in the loop. ## Screenshots | The settings panel with the **Notifications** entry in the sidebar and the section content | The sound picker for each kind (the official dropdown) | | --- | --- | |  |  | ## Install ```sh # Install from npm (requires dsh >= 0.1.0-rc.6) dsh plugin --profile web add @dingyi222666/dsh-session-notification # Restart dsh web for it to take effect dsh web ``` Everything lives in this plugin — no harness (host) changes: - The settings section is registered through the client slot system (`settings.section`), exactly like official sections. - Preferences persist in the browser (localStorage) and sync across tabs; nothing requires the host's `WEB_SETTINGS_NAMESPACES` or any other host-package change. (The node half still reserves the `dsh-session-notification`
Read the full READMEThe repository declares no license. Check with the authors before using it.
dsh-session-notification DSH plugin questions
How do I install dsh-session-notification?
Run `dsh plugin --profile web add @dingyi222666/dsh-session-notification` in your terminal, then restart dsh web with `dsh web`. The plugin will be active after the restart.
The browser notifications are not showing up. What should I do?
First, enable the 'Browser notifications' master switch in the Notifications settings section. If it's your first time, the browser will ask for permission—click 'Allow'. After that, test the notification using the 'Test notification' button in the same section. Also ensure your OS notification settings are not blocking dsh.
Can I use my own sound files instead of the built-in ones?
Yes. For each notification kind, select 'Custom audio' from the sound picker and upload an mp3, ogg, or wav file up to 1 MB. The custom file will replace the built-in sound for that kind. You can later remove it to revert to the default.
Why do I hear no sound when an event happens?
Check that the 'Sound' master switch is on and the volume slider is not at zero. Also, the browser requires a user interaction (click/tap) before it can play audio—so after you reload the page, click anywhere on the page first. Each notification kind also has its own enable switch; make sure the kind you expect is turned on.
Does this plugin work with dsh CLI or only the web GUI?
This plugin is specifically for the dsh web GUI. It registers a settings section in the web interface and uses browser APIs for sound and notifications. It does not affect the CLI experience.