dsh-tab-alert

dsh routinely runs long background tasks—model questions, plan reviews, goal-stage transitions—while you have already switched to another window. dsh-tab-alert turns those moments where dsh genuinely needs you into a quiet system notification: when the tab is unfocused or hidden, a silent notification appears and the browser icon blinks in the OS taskbar (an orange flash on Windows, a notification plus Dock pulse on Linux). You can sense dsh is waiting without keeping the tab pinned open.\n\nNotifications fire only on actions that require input: model questions, authorization requests, plan reviews, goal completion or failure, background task endings, sessions completed elsewhere, and the current turn finishing. Ordinary replies stay silent. Each event triggers exactly one notification; returning to the page is treated as handled, and no further pings follow. The plugin subscribes only to official snapshots, creates notifications on its own, never mutates other plugins' state, and cleans up completely on uninstall. Every event is also published as a passive cordis event so other plugins can observe without coupling.\n\nBeyond alerts, dsh-tab-alert maintains a per-session state machine on the host side and broadcasts a normalized real-time task state—session title, status, wait reason, streaming text, and more—through a single WebSocket endpoint. One data stream, many consumers: the official companion plugin dsh-pet renders it as a desktop status panel, and third-party developers can build tray icons, audio announcements, kanban boards, or any custom client on top of the same endpoint. If you want timely dsh alerts without staring at the screen and also want external tools to tap into live session dynamics, this plugin covers both in a single install.