AO

Desktop notifier

Native macOS / Linux notifications. Silent no-op on Windows.

Slot: notifier · Name: desktop
macOSSupported
LinuxSupported
WindowsNot supported

On Windows this notifier logs a warning and does nothing — use Discord, Slack, or webhook instead.

Use

agent-orchestrator.yaml
notifier:
  - type: desktop
    sound: true            # default
Config keyDefaultWhat it does
soundtruePlay the system notification sound

How it works

  • macOS: osascript runs a display notification AppleScript — shows in the Notification Center.
  • Linux: notify-send from libnotify-bin. Most desktop environments ship this out of the box.
  • Windows: logs a warning line and returns. No toast support (yet).

Troubleshooting

  • macOS 14+ silence. System Settings → Notifications → Terminal (or your terminal app) → Allow notifications.
  • Linux notify-send not found. sudo apt install libnotify-bin (Debian/Ubuntu) or equivalent.
  • Windows shows no toast. Expected — this notifier is a no-op on Windows. Add a Discord/Slack/webhook notifier in the same list.