36 lines
1.4 KiB
Plaintext
36 lines
1.4 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." />
|
|
|
|
## Use
|
|
|
|
```yaml title="agent-orchestrator.yaml"
|
|
notifier:
|
|
- type: desktop
|
|
sound: true # default
|
|
```
|
|
|
|
| Config key | Default | What it does |
|
|
|---|---|---|
|
|
| `sound` | `true` | Play 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.
|