citisen/dsh-sentry

Flags a DSH session that is waiting on you through the three channels a background tab still has: its icon, its title and a chime.

Answers the question a background tab cannot: which session wants me? Only three channels survive when the page is hidden — the favicon, the title and a sound — so the plugin drives all three, and its settings document decides what each state does. It reads a session waiting on you from uiSession.pendingInteractions on the 0.1.5 line and from uiSession.sessionStatus on 0.1.7, treats a freshly finished turn as an edge rather than a sticky summary.completed flag, and refuses to chime on a turn that merely started. The README is unusually honest about what it cannot do: a page cannot know the browser's chrome colour, so the fish in the icon is only visible where the tab bar differs from it, some browsers cannot render motion in a favicon at all, and AudioContext starts suspended until a user gesture, so the first chime may be silent. Its configuration is a small document with presets for colour, tone and volume, validated with the failing line number reported under the editor, and the settings row is English/Chinese only, matching the shipped locale pair.

Notifications & Integrations ★ 0 updated 2026-09-24
View on GitHub ↗

Install

dsh plugin --profile web add @citisen/dsh-sentry

The npm line. Worth knowing before installing: this README opens with a recovery chapter rather than a feature list, because an enabled row that never activates is a failed boot in this plugin's own history. Its row id in the profile is alert, and three documented escape hatches all work while dsh cannot start — add - id: alert / disabled: true to $DSH_HOME/profiles/web/cordis.patch.yml, pass a one-boot overlay with dsh --profile web --patch ./no-sentry.yml web, or remove the package (dsh plugin --profile web remove @citisen/dsh-sentry, which needs pnpm on PATH; without it, delete the name from dsh.profile.bundles and dependencies by hand).

Compatibility

One build speaks both dsh lines — the 0.1.5-rc.x line and 0.1.7-alpha.1 — and both settings models are bound optionally, so a dsh that provides neither still activates on shipped defaults instead of sitting pending. That optional binding is the fix for its own history: up to 0.1.1 the plugin required the 0.1.5 settings service and was reported as an entry that "did not activate" on 0.1.7. The same string, alert, names the settings section on both lines, which matters because 0.1.7 keys settings by Loader entry id.

Details

Alternatives

ChuanTianML/dsh-open-with · mingzeng21/dsh-notion · YZz-S/dsh-notifier

More plugins in Notifications & Integrations

Browse more in Notifications & Integrations

Guides for Notifications & Integrations plugins