dsh-system-notify

Overview

Codex-style desktop notifications for DeepSeek Harness: task finished, errors, questions and goals, with configurable events, custom sounds, notification style, privacy, interactive approve/answer buttons and click-to-focus. Windows and Ubuntu.

README / EN

Package documentation

Registry summary

Codex-style desktop notifications for DeepSeek Harness: task finished, errors, questions and goals, with configurable events, custom sounds, notification style, privacy, interactive approve/answer buttons and click-to-focus. Windows and Ubuntu.

dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.

Read the full README on GitHub

LIMITATIONS

Known limitations

- Interactive approval always answers `allowed-once` or `rejected`; there is no “always allow” button. - Multiple questions in one request, or a notification daemon that hides actions, fall back to the Chat UI. - macOS interactive actions are not supported; macOS gets normal notifications only. - Windows notification volume is controlled by the system sound scheme; `sound.volume` applies to Ubuntu only. - Windows custom sounds must be WAV; a successful upload is stored locally and referenced by absolute path. - Clicking focuses the DSH window, not a specific session: DSH’s deep link is `dsh://open`. - Linux click/interactive support depends on `gdbus`, `dbus-monitor`, and a notification daemon that implements the freedesktop spec; zenity is needed for text/checklist dialogs. - The macOS path is best-effort and click support requires `terminal-notifier`. - Toast banners may be suppressed by OS focus modes; this is expected system behaviour, not a plugin failure.

dsh-system-notify