Skip to main content

Local-Only Mode

UnfoldAI can run entirely locally, with no data sent to UnfoldAI servers.

Enabling Local-Only Mode​

// settings.json
{
  "unfoldai.privacy.localOnly": true
}

What Works in Local-Only Mode​

All core monitoring features continue working:

  • ✅ Real-time dashboard and health status
  • ✅ Activity feed and session timeline
  • ✅ Agent detection and multi-agent tracking
  • ✅ Episode detection and investigation
  • ✅ Proactive alerts (all 6 triggers)
  • ✅ Drift detection and alerts
  • ✅ Restore points
  • ✅ UnfoldAI Terminal with full tracking
  • ✅ MCP server (returns locally available data)
  • ✅ Webhook notifications

What's Disabled in Local-Only Mode​

AI-powered features that require backend processing are disabled:

  • ❌ AI chat messages
  • ❌ AI commit message generation
  • ❌ Debug reports and fix plans
  • ❌ AI run narratives
  • ❌ Cloud playbook storage and retrieval

When to Use Local-Only Mode​

  • Working with sensitive or classified codebases
  • Operating in air-gapped environments
  • Organizational policies that restrict cloud data transmission
  • Personal preference for maximum privacy

For more details, see Privacy & Data Handling.