---
name: hd-notifications-mac
description: >
  macOS platform companion to hd-notifications — the Apple-specific half of how
  Hydrogen Desktop reaches the user outside the window. The generic notify handler,
  payload shape, levels, and /ui/toast live in hd-notifications (adom/hd-bootstrap);
  THIS skill carries only the macOS delivery mechanics: Notification Center toasts,
  the emergency Dock-icon attention bounce, and the System Settings → Notifications
  grant. Mirror of hd-notifications-windows (WinRT/AUMID). Trigger words — macos
  notification, notification center, dock bounce, request attention macos, allow
  notifications macos, toast on mac.
---

# hd-notifications (macOS) — Notification Center + Dock attention

This is the **macOS half** of `hd-notifications`. The cross-platform contract — the
`notify` message, the `NotifyPayload` (`title`/`body`/`level`/`actions`), the levels
`info|warning|error|emergency`, and the in-app `POST /ui/toast` — is identical on
every host and lives in the generic **hd-notifications** skill. Read that first; this
skill only documents what's Apple-specific.

## Delivery

- **Toasts → macOS Notification Center.** A `notify` surfaces as a system
  notification (short for `info`, long-duration for `warning`/`error`/`emergency`),
  rendered by `notifications.rs` → `show_toast`.
- **`emergency` → persistent Dock-icon bounce.** On top of the toast, HD calls
  `request_user_attention(Critical)` on the main window and shows/unminimizes it. On
  macOS this **bounces HD's Dock icon persistently** and keeps demanding attention
  until the user clicks through themselves — a programmatic focus does NOT clear it.
- **Identity.** Toasts surface under the **"Adom"** title (HD prefixes `title` with
  `"Adom: "` unless it already starts with "Adom"), and the notification is attributed
  to HD's **app bundle** — not via a Start-Menu-shortcut AUMID (that's the Windows
  path; see hd-notifications-windows).

## macOS gotcha — the Notifications grant

macOS gates notifications per-app: the user must allow **Hydrogen Desktop** under
**System Settings → Notifications**. If toasts never appear (but the in-app
`/ui/toast` works), that grant is the first thing to check — there's no Windows-style
"always works" toast. Unlike Screen Recording / Accessibility, HD does not block setup
on it; it's best-effort.

## NOT here (lives in the Windows companion)

WinRT toast templates, the Start-Menu-shortcut **AUMID** wiring, and taskbar flash are
the Windows delivery — see `hd-notifications-windows`. Do not apply that machinery on
macOS.