Terminal Configuration

UnfoldAI provides a dedicated terminal profile with enhanced command tracking, and it can also monitor standard VS Code/Cursor terminals when shell integration is available. This page covers both the UnfoldAI Terminal settings and the native terminal requirements for reliable monitoring.

For a full feature overview, see UnfoldAI Terminal.

Key Settings

// settings.json
{
  // Welcome banner display: "auto" | "full" | "compact" | "hidden"
  "unfoldai.terminal.welcomeMode": "auto",

  // Redraw filtering: "balanced" | "strict" | "off"
  "unfoldai.terminal.redrawMode": "balanced",

  // Command timeout in milliseconds (30,000–3,600,000)
  "unfoldai.terminal.commandTimeoutMs": 300000,

  // Show status chip after command completion
  "unfoldai.terminal.completionChips.enabled": false,

  // Enable terminal quick action commands
  "unfoldai.terminal.quickActions.enabled": true,

  // Persist workspace command history
  "unfoldai.terminal.historyPersistence.enabled": false,
  "unfoldai.terminal.historyPersistence.maxEntries": 120,

  // Share anonymous terminal reliability telemetry
  "unfoldai.terminal.reliabilityTelemetry.enabled": true
}

Shell Compatibility

Shell	Platform	Support
bash	macOS, Linux	✅ Full
zsh	macOS, Linux	✅ Full
fish	macOS, Linux	✅ Full
PowerShell / pwsh	Windows	✅ Full
Git Bash	Windows	✅ Full (native terminal monitoring)
cmd	Windows	⚠️ Basic (no shell integration hooks)

warning

Windows Command Prompt (cmd) does not support shell integration hooks. Use PowerShell or pwsh for full terminal monitoring capabilities.

Native Terminal Monitoring Requirements

If you want UnfoldAI to track commands from your normal VS Code/Cursor terminals, make sure shell integration is enabled in the editor and restart any terminals that were already open.

// settings.json
{
  "terminal.integrated.shellIntegration.enabled": true
}

After changing this setting, close and reopen the affected terminals. Shell integration is only applied when a terminal is created.

tip

Terminal > Integrated > Shell Integration: Decorations Enabled is optional. Decorations improve the visual command markers in the terminal, but UnfoldAI does not require them for capture.

Recommended Windows Setup

For the most reliable native monitoring on Windows:

• Prefer PowerShell 7 (pwsh) when available
• Windows PowerShell is also supported
• Avoid Command Prompt (cmd) for normal UnfoldAI monitoring
• If native capture still looks partial, reopen the terminal after confirming shell integration is enabled

Keyboard Shortcuts

Shortcut	Action
Ctrl+Shift+U / Cmd+Shift+U	Open UnfoldAI Terminal
Ctrl+Shift+Alt+U / Cmd+Shift+Alt+U	New UnfoldAI Terminal instance

Quick Actions

Command	Description
UnfoldAI: Copy Last Clean Output	Copies the last command's output without terminal formatting noise
UnfoldAI: Rerun Last Command	Re-executes the most recent command
UnfoldAI: Explain Last Error	Opens a chat to analyze the last terminal error

For the full settings reference, see Extension Settings Reference.