Skip to main content

Terminal Configuration

Use the UnfoldAI Terminal to keep command results close to your review workflow. UnfoldAI can also capture commands from ordinary editor terminals when VS Code shell integration is available.

Key Settings​

Open VS Code Settings, search for UnfoldAI Terminal and choose your preferences. For a quieter welcome banner:

{
"unfoldai.terminal.welcomeMode": "compact"
}

Choose hidden to hide the greeting. Keep other terminal settings at their defaults unless you need to resolve a specific display issue.

Shell Compatibility​

Use Bash, Zsh or Fish on macOS/Linux, or PowerShell / pwsh on Windows. Git Bash can also work with ordinary editor terminal capture on Windows. Command Prompt (cmd) has basic support and does not provide the same command-capture capabilities.

Capture can vary by shell, command and development environment. Review any capture-quality notice alongside the project's own output.

Native Terminal Monitoring Requirements​

To capture commands from ordinary VS Code or Cursor terminals:

  1. Open Settings and search for Terminal → Integrated → Shell Integration.
  2. Enable shell integration.
  3. Close and reopen the terminal.
  4. Run a small command and check whether it appears in UnfoldAI.

You can also set the editor preference directly:

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

Choose PowerShell 7 (pwsh) when available, or Windows PowerShell. Reopen terminals after changing your shell or shell-integration settings. If capture still looks incomplete, try a new UnfoldAI Terminal and follow terminal troubleshooting.

Keyboard Shortcuts​

ShortcutAction
Ctrl+Shift+U / Cmd+Shift+UOpen UnfoldAI Terminal
Ctrl+Shift+Alt+U / Cmd+Shift+Alt+UOpen a new UnfoldAI Terminal instance

Quick Actions​

Open the Command Palette to find:

CommandAction
UnfoldAI: Copy Last Clean OutputCopy the last command's output for review
UnfoldAI: Rerun Last CommandRun the most recent command again
UnfoldAI: Explain Last ErrorOpen a conversation about the last terminal error

Check what a command does before rerunning it. For an overview, see UnfoldAI Terminal.