Proactive Alerts

Proactive Alerts are UnfoldAI's way of tapping you on the shoulder when something needs attention. Unlike traditional notifications, they appear as contextual messages in UnfoldAI's conversation stream with one-click actions.

Alert Types

UnfoldAI generates proactive alerts for six trigger categories:

Trigger	What It Means
Pre-commit risk	Risk signals have accumulated — review before committing
Drift detected	An agent appears stuck in a loop or making no progress
Problem accumulation	Multiple issues are building up in the workspace
Episode created	A new error episode has been detected
Episode resolved	A previously active episode has been resolved
Session wrap-up	End-of-session summary of what happened

How Alerts Appear

Proactive alerts appear in three places:

1. Conversation stream — As messages in the UnfoldAI Agent chat, with action buttons
2. Dashboard cards — As prominent cards for high-priority alerts
3. Status bar — Brief highlight for high-priority alerts

Each alert includes a contextual message explaining what happened and suggested actions you can take with one click.

Alert Actions

Depending on the alert type, actions may include:

• Analyze — Dig deeper into the issue
• Generate Report — Create a detailed debug report
• Restore Checkpoint — Revert to a known-good state
• View Episode — Open the related Episode
• Dismiss — Acknowledge and clear the alert

Dismissal & Quiet Periods

If you dismiss several alerts in a row, UnfoldAI goes quiet for a configurable period. This prevents alert fatigue — if you're focused on something and don't need interruptions, UnfoldAI backs off.

Configuration

// settings.json
{
  // Enable/disable proactive alerts entirely
  "unfoldai.proactive.enabled": true,

  // Minimum seconds between alerts
  "unfoldai.proactive.minInterval": 60,

  // Minimum drift severity to trigger an alert: "low" | "medium" | "high"
  "unfoldai.proactive.driftSeverityThreshold": "medium",

  // Number of consecutive dismissals before quiet period
  "unfoldai.proactive.suppressAfterDismissals": 3,

  // Play a sound for alerts
  "unfoldai.proactive.soundEnabled": false
}

Webhook Integration

For high-priority alerts, you can configure a webhook to send notifications to external services like Slack or Discord.

Webhook Configuration →

Availability

Proactive Alerts are available on all plans, including Free. All six trigger types are included in every tier.