USER MANUAL · SYSTEM

Notifications

Multi-channel notification system for real-time alerts, approvals, and operational events.

/notifications

Overview#

ClawButler delivers notifications through four channels: in-app (via Server-Sent Events), email (SMTP), Web Push (VAPID), and Mobile Push (Expo / APNs / FCM). You receive timely alerts for pending approvals, agent health changes, budget overages, and automation results.

Each user can configure notification preferences per channel, set quiet hours to suppress non-critical alerts during off-hours, and adjust cooldown intervals to prevent notification fatigue.

Prerequisites#

Prerequisites

A ClawButler account (in-app notifications work out of the box)
Optional: email address configured for email notifications, or browser/mobile push permissions granted

Expected Results#

Once configured, you will see:

-Notification inbox with unread count badge in the sidebar and header
-Per-notification detail showing event type, timestamp, related agent or resource, and a link to the source
-Preferences panel where you toggle channels, set quiet hours, and configure cooldown intervals

Web Operations#

Navigate to the Notifications page from the sidebar under System, or click the bell icon in the header.

Notification Inbox

The inbox lists all notifications in reverse chronological order. Each entry shows the event type badge, a summary message, timestamp, and a link to the related resource. Unread notifications are highlighted with a dot indicator.

Mark Read

Click a notification to mark it as read, or use the 'Mark All Read' button at the top to clear all unread indicators at once. Read status syncs across devices.

Preferences

Open the Preferences panel to toggle notification channels (in-app, email, Web Push) and select which event types trigger notifications. You can enable or disable each channel independently.

Quiet Hours

Set a daily quiet-hours window (e.g., 22:00 - 08:00) during which non-critical notifications are held and delivered as a batch summary when the window ends. Critical alerts (kill switch, budget breach) always deliver immediately.

CLI Operations#

List recent notifications with optional unread-only filter

Terminal

$ ap notification list

Mobile Operations#

On mobile, the Notifications screen is accessible from the bottom navigation. Features include:

-Push notifications delivered via Expo / APNs / FCM — tap to navigate directly to the related resource
-Badge count on the app icon reflecting unread notification count
-Pull-to-refresh and mark-read gestures for quick inbox management

FAQ#

Q: How do I enable push notifications?

A: On Web, click 'Enable Push' in the Preferences panel — your browser will prompt for notification permission. On mobile, grant notification permissions when the app requests them. Push notifications require a valid VAPID configuration (Web) or Expo push token (mobile).

Q: What events trigger notifications?

A: By default, notifications are sent for pending approvals, agent health changes (healthy to error), budget overage warnings, kill switch activations, and automation failures. You can customize which event types trigger notifications in the Preferences panel.

Q: How do I set quiet hours?

A: Go to Notifications > Preferences > Quiet Hours. Set a start and end time (in your local timezone). During quiet hours, non-critical notifications are queued and delivered as a summary when the window ends. Critical alerts always bypass quiet hours.