Notification

Action bell

action.notification

Display a native macOS notification banner with a customizable title, body, and optional click action URL. When the user clicks the notification, the action URL opens in the default handler (browser for HTTP links, Finder for file paths).

By default, notifications are forced to display even when Do Not Disturb is active. This can be toggled off for less critical alerts.

Ports

DirectionNameData TypeDescription
InputInputAnyIncoming payload for template interpolation

Configuration

FieldTypeDefaultDescription
titleTextNotification title. Supports {{var}} interpolation.
bodyText AreaNotification body text. Supports {{var}} interpolation.
actionURLTextURL or file path opened when notification is clicked. Supports {{var}}.
forceDisplayBooleantrueAlways display even during Do Not Disturb.

Output Variables

VariableTypeDescription
notifiedBooleanWhether notification was sent
titleStringResolved notification title
bodyStringResolved notification body

Example

Alert when a watched file changes: