Notifications

SwarmClaw includes a real-time Notification Center in the sidebar and mobile header.

Notification Center UX

  • live updates via WebSocket invalidation
  • unread badge counter
  • mark-all-read
  • clear-read notifications
  • optional action link per notification
  • operational alerts for automatic safety actions such as extension auto-disable

Notification Schema

Each notification includes fields such as:

  • id
  • type
  • title
  • message
  • actionLabel
  • actionUrl
  • read
  • createdAt
  • entityType
  • entityId
  • dedupKey

API

  • GET /api/notifications?unreadOnly=true&limit=100
  • POST /api/notifications
  • DELETE /api/notifications
  • PUT /api/notifications/:id
  • DELETE /api/notifications/:id

Outbound Webhook Alerts

Notifications can be forwarded to an external webhook for ops alerting. Configure in Settings:

  • alertWebhookUrl
  • alertWebhookType
  • alertWebhookEvents

Alerts are rate-limited and best-effort.

CLI Examples

swarmclaw notifications list --query unreadOnly=true
swarmclaw notifications create --data '{"type":"info","title":"Release ready","message":"Tag vX.Y.Z to publish"}'
swarmclaw notifications mark-read <notificationId>
swarmclaw notifications clear