Extension Settings Reference
Search for unfoldai in VS Code settings or edit settings.json.
V5 Command Center
| Setting | Type | Default | Description |
|---|---|---|---|
unfoldai.v5.safeAgentMode.enabled | boolean | false | Enables the v5 Command Center, Activity, Safety, MCP-lite, and local validation loop. |
unfoldai.v5.safeAgentMode.beta | boolean | true | Shows beta labeling for the v5 Safe Agent Mode surfaces. |
unfoldai.v5.activity.defaultViewEnabled | boolean | true | Allows the Activity evidence view when v5 is enabled. |
unfoldai.v5.validation.enabled | boolean | true | Enables deterministic Validate Session checks. |
unfoldai.v5.cards.maxOpenCards | number | 5 | Caps visible open Safety cards. |
Privacy And Storage
| Setting | Type | Default | Description |
|---|---|---|---|
unfoldai.v5.privacy.uploadMode | enum | analytics_metadata | Controls v5 analytics upload. Use local_only to suppress v5 analytics. |
unfoldai.v5.localStore.engine | enum | auto | Uses the safest available local evidence store. JSONL is the fallback. |
unfoldai.privacy.localOnly | boolean | false | Disables backend/cloud features for legacy and shared surfaces where supported. |
Raw code, diffs, terminal output, full paths, diagnostic messages, secrets, and raw v4 events/tasks are not sent by default by the v5 Command Center, Safety, MCP-lite, verification prompts, or recovery prompts.
MCP-lite
| Setting | Type | Default | Description |
|---|---|---|---|
unfoldai.mcp.enabled | boolean | false | Enables the local MCP server for compatible agents. |
unfoldai.v5.mcp.enabled | boolean | false | Keeps v5 MCP-lite behind an explicit setting. |
MCP-lite setup is manual in this release. UnfoldAI does not edit agent configuration files automatically.
AI Investigation
| Setting | Type | Default | Description |
|---|---|---|---|
unfoldai.v5.llm.investigation.enabled | boolean | false | Enables the v5 AI Investigation feature gate. |
unfoldai.v5.llm.investigation.realProviderEnabled | boolean | false | Allows the real backend provider path when auth, quota, and backend flags permit it. |
AI Investigation requires sign-in and backend availability. Local guest users still get deterministic local validation, Safety, checkpoints, MCP-lite metadata tools, and prompt generation.
Terminal Capture
| Setting | Type | Default | Description |
|---|---|---|---|
unfoldai.terminal.welcomeMode | enum | auto | Welcome banner display. Options: auto, full, compact, hidden. |
unfoldai.terminal.historyPersistence.enabled | boolean | false | Persist workspace command history for legacy terminal workflows. |
unfoldai.terminal.historyPersistence.maxEntries | number | 120 | Max persisted terminal history entries. |
Terminal capture quality varies by shell and remote environment. Prefer
PowerShell or pwsh on Windows for the strongest VS Code shell integration.
Example Configuration
{
"unfoldai.v5.safeAgentMode.enabled": true,
"unfoldai.v5.privacy.uploadMode": "local_only",
"unfoldai.mcp.enabled": true,
"unfoldai.v5.mcp.enabled": true,
"unfoldai.v5.llm.investigation.enabled": false,
"unfoldai.v5.llm.investigation.realProviderEnabled": false
}