| name | agent-notify |
| description | Create, list, respond to, and manage notifications through the notification service. Use for alerts, inter-agent messaging, and actionable prompts. |
Agent Notify
Skill for interacting with the agentd notification service — a message bus for alerts, prompts, and inter-agent communication.
Creating Notifications
agent notify create \
--title "Build complete" \
--message "All tests passed on main"
agent notify create \
--source system \
--priority high \
--title "Deployment failed" \
--message "Error in production deploy pipeline"
agent notify create \
--title "Approve deployment?" \
--message "Release v1.2.3 is ready to deploy to production" \
--requires-response true
agent notify create \
--lifetime persistent \
--title "Maintenance scheduled" \
--message "Database migration at 2am UTC"
agent notify create \
--lifetime ephemeral \
--expires-in 3600 \
--title "Cache warming" \
--message "Cache rebuild in progress"
Source Types
system — generated by agentd services
ask — generated by the ask service
monitor — generated by the monitor daemon
hook — generated by git/shell hooks
Priority Levels
low — informational, non-urgent
normal — default priority
high — important, should be seen soon
urgent — requires immediate attention
Lifetime
ephemeral — auto-expires (use --expires-in for TTL in seconds)
persistent — remains until explicitly dismissed or deleted
Listing Notifications
agent notify list
agent notify list --status pending
agent notify list --status viewed
agent notify list --status dismissed
agent notify list --status responded
agent notify list --status expired
agent notify list --actionable true
agent notify count
agent notify list --json
Reading and Responding
agent notify get <notification-id>
agent notify respond <notification-id> "Approved — go ahead with deploy"
Deleting Notifications
agent notify delete <notification-id>
Health Check
agent notify health