notifications

name	notifications
description	In-app notifications primitive with pluggable server-side channels. Use when the agent needs to surface progress, alerts, or completions to the user — both in-app (bell + toast) and out-of-band (webhook, Slack, custom).

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"

Severity	When
info	FYI / progress / confirmation
warning	Something to look at soon
critical	Needs immediate attention

Optional: --metadataJson '{"threadId":"abc"}', --channels inbox,webhook (omit to run all registered).

Delivery