diff --git a/skills/clawdis-notify/SKILL.md b/skills/clawdis-notify/SKILL.md new file mode 100644 index 000000000..b3d9b94a3 --- /dev/null +++ b/skills/clawdis-notify/SKILL.md @@ -0,0 +1,58 @@ +--- +name: clawdis-notify +description: Send system notifications to specific Clawdis nodes (macOS computers) via the Gateway and CLI. Use when you need to alert a person or confirm a remote action on a particular machine, or when an agent must push a notification to another computer. +--- + +# Clawdis Notify + +## Overview + +Send local notifications to a specific Clawdis node (currently macOS only) via the Gateway CLI. + +## Quick start + +1) Find a target node. +```bash +clawdis nodes status +clawdis nodes describe --node +``` + +2) Send the notification. +```bash +clawdis nodes notify --node --title "Ping" --body "Gateway ready" +``` + +## Core command + +`clawdis nodes notify --node [--title ] [--body ] [--sound ] [--priority ] [--delivery ]` + +Notes: +- Provide at least one of `--title` or `--body`. +- `--delivery` defaults to `system`. +- Only macOS nodes expose `system.notify` right now. +- Notification permission must be granted in the macOS app or the command fails. + +## Multi‑computer usage + +Pick a specific node by id/name/IP, or iterate across nodes: + +```bash +for node in $(clawdis nodes status --json | jq -r '.nodes[].id'); do + clawdis nodes notify --node "$node" --title "Heads up" --body "Maintenance in 5 minutes" +done +``` + +## Troubleshooting + +- `nodes notify failed: ...` usually means the node is offline, not paired, or missing permission. +- If the Gateway is down or unreachable, notifications cannot be delivered. + +## Low‑level fallback (rare) + +If needed, use raw invoke: +```bash +clawdis nodes invoke \ + --node \ + --command system.notify \ + --params '{"title":"Ping","body":"Hello","sound":"Glass","priority":"active","delivery":"system"}' +```