56 lines
2.0 KiB
Plaintext
56 lines
2.0 KiB
Plaintext
---
|
|
title: Desktop notifier
|
|
description: Native macOS / Linux notifications. Silent no-op on Windows.
|
|
---
|
|
|
|
<div style={{ display: "flex", alignItems: "center", gap: "0.75rem", margin: "0.5rem 0 1.25rem" }}>
|
|
<Logo name="apple" size={28} color />
|
|
<span style={{ fontSize: "0.8125rem", color: "var(--color-fd-muted-foreground)" }}>Slot: <code>notifier</code> · Name: <code>desktop</code></span>
|
|
</div>
|
|
|
|
<PlatformSupport macos="full" linux="full" windows="none" note="On Windows this notifier logs a warning and does nothing — use Discord, Slack, or webhook instead." />
|
|
|
|
## Setup
|
|
|
|
Run the setup command on macOS:
|
|
|
|
```bash
|
|
ao setup desktop
|
|
```
|
|
|
|
AO asks which desktop backend to use and which notification priorities desktop
|
|
should receive: `urgent-only`, `urgent-action`, or `all`. For scriptable setup,
|
|
pass `--routing-preset <preset>`.
|
|
|
|
## Use
|
|
|
|
```yaml title="agent-orchestrator.yaml"
|
|
notifiers:
|
|
desktop:
|
|
plugin: desktop
|
|
backend: ao-app
|
|
dashboardUrl: http://localhost:3000
|
|
|
|
notificationRouting:
|
|
urgent: [desktop]
|
|
action: [desktop]
|
|
```
|
|
|
|
| Config key | Default | What it does |
|
|
|---|---|---|
|
|
| `backend` | `auto` | `ao-app`, `terminal-notifier`, `osascript`, or auto fallback |
|
|
| `dashboardUrl` | dashboard port | URL opened from desktop notification actions |
|
|
| `appPath` | macOS app install path | Custom AO Notifier.app path |
|
|
|
|
## 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.
|