mirror of
https://github.com/cline/cline.git
synced 2026-09-21 05:10:09 +08:00
63 lines
2.2 KiB
Plaintext
63 lines
2.2 KiB
Plaintext
---
|
|
title: "Terminal Quick Fixes"
|
|
sidebarTitle: "Terminal Quick Fixes"
|
|
description: "Quick solutions for common terminal issues"
|
|
---
|
|
|
|
## Try This First: Background Execution
|
|
|
|
The simplest fix for most terminal issues is switching to **Background Execution**:
|
|
|
|
1. Click **Settings** (top right of Cline chat)
|
|
2. Go to **Terminal Settings**
|
|
3. Set **Terminal Execution Mode** → **Background Exec**
|
|
|
|
This runs commands in a background process instead of VS Code's integrated terminal, bypassing most integration issues.
|
|
|
|
---
|
|
|
|
## Other Fixes
|
|
|
|
If you still need VS Code's integrated terminal fallback, try these compatibility fixes:
|
|
|
|
- **Switch to bash** (solves most instances)
|
|
|
|
1. Within Cline, 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 (terminal fallback)"** and select **"bash"** from the drop-down
|
|
|
|
- **Increase timeout**
|
|
|
|
1. Within Cline, 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 for terminal fallback (seconds)" and enter **"10"** into the text field
|
|
|
|
- **Disable terminal reuse**
|
|
1. Within Cline, 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 for terminal fallback"**, and **uncheck** this option
|
|
|
|
## Platform-Specific Fixes
|
|
|
|
### macOS + Oh-My-Zsh
|
|
|
|
```bash
|
|
# Create minimal config for VSCode
|
|
echo 'export TERM=xterm-256color' > ~/.zshrc-vscode
|
|
echo 'export PAGER=cat' >> ~/.zshrc-vscode
|
|
```
|
|
|
|
### Windows PowerShell
|
|
|
|
```powershell
|
|
# Run as Administrator
|
|
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
|
|
```
|
|
|
|
### WSL
|
|
|
|
- Open folder from WSL: `code .`
|
|
- Select **"WSL Bash"** in Cline settings, under **"Terminal Settings"**
|
|
- Increase **"Shell integration timeout (seconds)"** to **15**
|
|
|