Configuration

The settings namespace is macos-notify. Values changed from the Web card apply live.

Option	Default	Description
`onCompleted`	`true`	Notify when a turn completes normally.
`onError`	`true`	Notify for errors and blocked turns. These alerts bypass completion gates and digesting.
`onAborted`	`false`	Notify when a user aborts a turn.
`onApproval`	`true`	Notify immediately when a tool waits for approval.
`minDurationSec`	`30`	Suppress completed-turn notifications shorter than this many seconds; `0` disables the threshold.
`onlyWhenIdleSec`	`0`	Require this many seconds of keyboard/mouse idle time for completed notifications; `0` disables idle gating.
`onlyWhenUnfocused`	`true`	Suppress completed notifications while any DSH Web tab is focused.
`digestMinutes`	`0`	Collect completed notifications into a periodic digest; `0` sends them immediately.
`includeSubagents`	`false`	Include subagent sessions instead of notifying only for top-level sessions.
`channel`	`auto`	`auto`, `osascript`, or `osc9`.
`sounds.completed`	`Glass`	Sound for completed turns.
`sounds.error`	`Basso`	Sound for errors, blocked turns, and rate limits.
`sounds.aborted`	empty	Sound for aborted turns; empty means silent.
`sounds.approval`	`Ping`	Sound for approval requests.
`coalesceMs`	`1500`	Window for merging simultaneous turn results; `0` disables merging.
`notifyOnLoad`	`true`	Send a test notification when the plugin loads.

dsh-macos-notify