Skip to main content

Terminal Quick Fixes

Here is a list of common fixes, starting with the most applicable:

  • Switch to bash (solves most instances)

    1. Within Caret, left-click the Settings button in the top right-hand corner of the chat window
    2. Once in the Settings window, left-click the "Terminal Settings" tab from the left-hand column
    3. Navigate to "Default Terminal Profile" and select "bash" from the drop-down

  • Increase timeout

    1. Within Caret, left-click the Settings button in the top right-hand corner of the chat window
    2. Once in the Settings window, left-click the "Terminal Settings" tab from the left-hand column
    3. Navigate to "Shell integration timeout (seconds)" and enter "10" into the text field

  • Disable terminal reuse

    1. Within Caret, left-click the Settings button in the top right-hand corner of the chat window
    2. Once in the Settings window, left-click the "Terminal Settings" tab from the left-hand column
    3. Look for "Enable aggressive terminal reuse", and uncheck this option

Platform-Specific Fixes​

macOS + Oh-My-Zsh​

# Create minimal config for VSCode
echo 'export TERM=xterm-256color' > ~/.zshrc-vscode
echo 'export PAGER=cat' >> ~/.zshrc-vscode

Windows PowerShell​

# Run as Administrator
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

WSL​

  • Open folder from WSL: code .
  • Select "WSL Bash" in Caret settings, under "Terminal Settings"
  • Increase "Shell integration timeout (seconds)" to 15

Full Guide​

For detailed troubleshooting, see the Complete Terminal Troubleshooting Guide.