Extension Settings Reference

All UnfoldAI settings can be configured in your VS Code settings.json or through the Settings UI (Ctrl+, / Cmd+,). Search for "unfoldai" to find all settings.

Settings support both user-level and workspace-level overrides using standard VS Code behavior.

General

Setting	Type	Default	Description
unfoldai.privacy.localOnly	boolean	false	Disable all backend/cloud features. Monitoring and local features continue.
unfoldai.agentFingerprints.override	object	{}	Custom agent identification configuration for unrecognized agents.

Episodes

Setting	Type	Default	Description
unfoldai.episodes.problemMinSeverity	enum	"error"	Minimum VS Code Problems severity to trigger episodes. Options: error, warning, info, hint
unfoldai.episodes.resolveQuietMinutes	number	5	Minutes of inactivity before an episode auto-resolves (1–60)
unfoldai.episodes.maxLookbackMinutes	number	15	How far back to look when grouping related events (1–180)

Drift Detection

Setting	Type	Default	Description
unfoldai.driftDetection.enabled	boolean	true	Enable drift detection monitoring
unfoldai.driftDetection.threshold	number	6	Repetitions before triggering a drift alert (3–20)

Proactive Alerts

Setting	Type	Default	Description
unfoldai.proactive.enabled	boolean	true	Enable proactive alert system
unfoldai.proactive.minInterval	number	60	Minimum seconds between proactive alerts
unfoldai.proactive.driftSeverityThreshold	enum	"medium"	Minimum drift severity to trigger alert. Options: low, medium, high
unfoldai.proactive.suppressAfterDismissals	number	3	Consecutive dismissals before quiet period
unfoldai.proactive.soundEnabled	boolean	false	Play a sound for proactive alerts
unfoldai.proactive.webhookEnabled	boolean	false	Send high-priority alerts to webhook URL
unfoldai.proactive.webhookUrl	string	""	Webhook endpoint URL

MCP Server

Setting	Type	Default	Description
unfoldai.mcp.enabled	boolean	false	Enable the local MCP server for external agent access

Restore Points

Setting	Type	Default	Description
unfoldai.restorePoints.enabled	boolean	true	Enable restore point system
unfoldai.restorePoints.autoOnInstallCommands	boolean	true	Auto-create restore points before install-like commands

Lockfile Monitoring

Setting	Type	Default	Description
unfoldai.lockfiles.enabled	boolean	true	Monitor lockfile and manifest changes
unfoldai.lockfiles.files	string[]	See note	Lockfile patterns to watch (defaults include package-lock.json, pnpm-lock.yaml, etc.)
unfoldai.lockfiles.manifests	string[]	See note	Manifest patterns to watch (defaults include package.json, pyproject.toml, etc.)

Terminal

Setting	Type	Default	Description
unfoldai.terminal.welcomeMode	enum	"auto"	Welcome banner display. Options: auto, full, compact, hidden
unfoldai.terminal.redrawMode	enum	"balanced"	Redraw filtering mode. Options: balanced, strict, off
unfoldai.terminal.commandTimeoutMs	number	300000	Command timeout in milliseconds (30,000–3,600,000)
unfoldai.terminal.completionChips.enabled	boolean	false	Show status chip after command completion
unfoldai.terminal.quickActions.enabled	boolean	true	Enable terminal quick action commands
unfoldai.terminal.historyPersistence.enabled	boolean	false	Persist workspace command history
unfoldai.terminal.historyPersistence.maxEntries	number	120	Max persisted history entries (20–500)
unfoldai.terminal.reliabilityTelemetry.enabled	boolean	true	Share anonymous terminal reliability telemetry

Advanced / Debug

Setting	Type	Default	Description
unfoldai.attribution.logLevel	enum	"info"	Attribution log verbosity. Options: none, errors, warnings, info, debug
unfoldai.auth.refreshBetaEnabled	boolean	true	Enable auth token refresh beta
unfoldai.auth.clientChannel	enum	"stable"	Extension update channel. Options: stable, beta

Example Configuration

// settings.json — Common customizations
{
  // Relax drift detection for long-running tasks
  "unfoldai.driftDetection.threshold": 10,

  // Only alert on high-severity drift
  "unfoldai.proactive.driftSeverityThreshold": "high",

  // Enable MCP for Claude Code integration
  "unfoldai.mcp.enabled": true,

  // Quieter terminal experience
  "unfoldai.terminal.welcomeMode": "compact",

  // Auto-checkpoint before installs
  "unfoldai.restorePoints.autoOnInstallCommands": true,

  // Send critical alerts to Slack
  "unfoldai.proactive.webhookEnabled": true,
  "unfoldai.proactive.webhookUrl": "https://hooks.slack.com/services/YOUR/WEBHOOK/URL"
}