moon is able to send operating system desktop notifications for specific events in the action pipeline, on behalf of your terminal application. This is useful for continuous feedback loops and reacting to long-running commands while multi-tasking.
Notifications are opt-in and must be enabled with the notify.terminalNotifications setting.
notifier:
terminalNotifications: 'always'
Setup
Notifications must be enabled at the operating system level.
Linux
Ensure D-BUS support
Linux support is based on the XDG specification and utilizes D-BUS APIs, primarily the org.freedesktop.Notifications.Notify method. Refer to your desktop distribution for more information. Verify notifications work
Notifications will be sent using the moon application name (the current executable).
macOS
Open System Settings
Open “System Settings” or “System Preferences”.
Navigate to Notifications
Select “Notifications” in the left sidebar.
Configure terminal app
- Select your terminal application from the list (e.g., “Terminal”, “iTerm”, etc)
- Ensure “Allow notifications” is enabled
- Customize the other settings as desired
Notifications will be sent from your currently running terminal application, derived from the TERM_PROGRAM environment variable. If we fail to detect the terminal, it will default to “Finder”.
Windows
Requires Windows 10 or later.
Open Settings
Open “Settings” from the Start menu.
Navigate to System panel
Go to the “System” panel.
Enable notifications
- Select “Notifications & Actions” in the left sidebar
- Ensure notifications are enabled
Notifications will be sent from the “Windows Terminal” app if it’s currently in use, otherwise from “Microsoft PowerShell”.
