Terminal Issues

Shell Not Recognized

UnfoldAI supports the following shells:

Shell	Platform	Support
bash	macOS, Linux	✅ Full
zsh	macOS, Linux	✅ Full
fish	macOS, Linux	✅ Full
PowerShell / pwsh	Windows	✅ Full
cmd	Windows	⚠️ Basic

warning

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

Commands Not Being Tracked

1. Enable shell integration — UnfoldAI depends on VS Code/Cursor shell integration for reliable native terminal monitoring:

   {
     "terminal.integrated.shellIntegration.enabled": true
   }

2. Restart the terminal — Shell integration settings only apply to newly created terminals, so close and reopen the terminal after changing settings.
3. Use a supported shell — Prefer PowerShell / pwsh on Windows. cmd only has basic support and does not expose the hooks UnfoldAI needs for native tracking.
4. Use the UnfoldAI Terminal as fallback — Open with Ctrl+Shift+U / Cmd+Shift+U if you need the most reliable capture immediately.
5. Check redraw mode — If commands appear duplicated or missing, try adjusting:

   { "unfoldai.terminal.redrawMode": "strict" }

Shell Integration Unavailable

If UnfoldAI says native terminal capture is incomplete or shell integration is unavailable:

1. Open Settings
2. Search for Terminal > Integrated > Shell Integration
3. Confirm it is enabled
4. Reopen the terminal you want UnfoldAI to monitor

tip

Terminal > Integrated > Shell Integration: Decorations Enabled is optional. It controls editor UI markers, not the core capture capability UnfoldAI relies on.

Windows Shell Choice

For Windows native terminal monitoring:

• Best: pwsh
• Also supported: Windows PowerShell, Git Bash
• Avoid for full tracking: cmd

Welcome Banner Issues

Control the terminal greeting:

// "auto" | "full" | "compact" | "hidden"
{ "unfoldai.terminal.welcomeMode": "compact" }

Command Timeout

If long-running commands are being cut off:

{
  // Default is 300000ms (5 minutes), max is 3600000ms (1 hour)
  "unfoldai.terminal.commandTimeoutMs": 600000
}

Telemetry

To disable anonymous terminal reliability telemetry:

{ "unfoldai.terminal.reliabilityTelemetry.enabled": false }