​
Introduction

When using Qoder Agent mode, terminal execution relies heavily on your local environment and shell configuration. You may encounter issues such as:
  • Inability to launch the terminal
  • Commands not executing
  • No output returned
This topic provides common troubleshooting methods to resolve these issues.

​
Common troubleshooting methods

​
Method 1: Configure a supported shell

Qoder supports several shells. Ensure you’re using a compatible one.
  1. Open Qoder.
  2. PressCmd + Shift + P （MacOS）orCtrl + Shift + P(Windows/Linux) to open the Command Palette.
  3. Type Terminal: Select Default Profile and select it.
  4. Choose a supported shell:
    • Linux/macOS: bash, fish, pwsh, zsh
    • Windows: Git Bash, pwsh
  5. Completely close and reopen Qoder for changes to take effect.

​
Method 2: Manually install shell integration

If terminal integration still fails, install shell integration manually by adding the appropriate line to your shell’s configuration file.
  •  zsh (~/.zshrc): 
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path zsh)"
  • Bash (~/.bashrc):
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"
  •  PowerShell ($Profile):
[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"
  • Fish (~/.config/fish/config.fish):
string match -q "$TERM_PROGRAM" "vscode"; and . (code --locate-shell-integration-path fish)
After editing the file:
  1. Save the changes.
  2. Restart Qoder completely.
For other shells, refer to manual shell integration.

​
If issues persist

If you still don’t receive terminal output:
  • Click the “Terminate Terminal” button to close the current terminal session.
  • Run the command again. This refreshes the terminal connection and often resolves transient issues.

​
Windows-specific troubleshooting

​
Git Bash

  1. Download and install Git for Windows from: https://git-scm.com/downloads/win.
  2. Exit and reopen Qoder.
  3. Set “Git Bash” as the default terminal:  a. Open the Command Palette. b. Run: Terminal: Select Default Profile . c. Select Git Bash.

​
PowerShell

  1. Ensure you’re using PowerShell 7 or later.
    Check your version:
$PSVersionTable.PSVersion
  1. If needed, update PowerShell .
  2. By default, PowerShell restricts script execution for security. You may need to adjust the execution policy.
a. Open PowerShell as Administrator:
  • Press Win + X
  • Select Windows PowerShell (Admin) or Windows Terminal (Admin)
b. Check the current policy: 
Get-ExecutionPolicy

# If the output is RemoteSigned, Unrestricted, or Bypass, you probably do not need to change the execution policy. These settings should allow shell integration to work properly.
# If the output is Restricted or AllSigned, you may need to change the policy to enable shell integration.
c. Update the  policy for your user: 
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# This will set the RemoteSigned policy for the current user only, which is safer than changing it system-wide.
d. Confirm with Y when prompted, then verify: 
Get-ExecutionPolicy
e. Restart Qoder and retry.

​
WSL

If using Windows Subsystem for Linux (WSL): 
  1. Add the following line to your ~/.bashrc:
. "$(code --locate-shell-integration-path bash)"
2. Reload your shell or runsource ~/.bashrc. 3. Retry the terminal command in Qoder.

​
Other common issues

​
Unusual terminal output

If you see:
  • Garbled characters
  • Rectangular symbols
  • Escape sequences (e.g., ^[[1m, ^[[32m)
  • Control codes
This is often caused by third-party shell customizations, such as:
  • Powerlevel10k
  • Oh My Zsh
  • Custom fish themes
Solution
  1. Temporarily disable the customization in your shell config file.
For example, in ~/.zshrc, comment out the Powerlevel10k line: 
# source /path/to/powerlevel10k/powerlevel10k.zsh-theme
  1. Restart Qoder and test.
  2. If the issue is resolved, re-enable customizations one at a time to identify the conflicting component.
  3. For long-term use, look for configurations that are compatible with Qoder’s terminal integration.