notifications
Installation
SKILL.md
Notifications
notify() is the framework's "tell the user something" primitive. Every call persists a row to the inbox (drives the bell UI) and fans out to any registered server-side channels. Channels follow the same pluggable-provider pattern as tracking — register at startup, notify() fans out, errors are isolated.
Use for: agent progress milestones, automation triggers firing, background job completions, critical errors. Don't use for chat replies — those go through the conversation.
Tools
| Tool | Purpose |
|---|---|
notify |
Send a notification (severity + title + optional body/metadata/channels) |
list-notifications |
Show recent notifications for the current user |
Sending
notify --severity info --title "Booking confirmed" --body "Jane at 3pm"