Terminal Notifications

Receive desktop notifications for moon pipeline events directly from your terminal

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.

.moon/workspace.yml

notifier:
  terminalNotifications: 'always'

Setup

Notifications must be enabled at the operating system level.

Linux

1. 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.

2. Verify notifications work

   Notifications will be sent using the moon application name (the current executable).

macOS

1. Open System Settings

   Open “System Settings” or “System Preferences”.

2. Navigate to Notifications

   Select “Notifications” in the left sidebar.

3. 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.

1. Open Settings

   Open “Settings” from the Start menu.

2. Navigate to System panel

   Go to the “System” panel.

3. 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”.