AIRGAP StudioAIRGAP Studio

Terminal Troubleshooting

Troubleshooting guide for PowerShell and terminal issues

PowerShell Execution Policy Error

Symptoms

When running scripts in the terminal, you encounter an error like:

... cannot be loaded because running scripts is disabled on this system ...

Cause

The default PowerShell execution policy on Windows is set to Restricted.

Solution

# Check current execution policy
Get-ExecutionPolicy

# Change policy for the current user
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

If organizational policies prevent changes, contact your security administrator.

Shell Integration Issues

Symptoms

A warning icon appears next to the terminal prompt, or AIRGAP Assistant fails to correctly detect command execution results.

Solution

  1. Open settings with Ctrl+,.
  2. Search for terminal.integrated.shellIntegration.enabled.
  3. Set the value to true.
{
  "terminal.integrated.shellIntegration.enabled": true
}

When shell integration is properly enabled, a checkmark will appear to the left of the prompt.

Symptoms

You get errors saying commands like ollama, node, or python cannot be found.

'ollama' is not recognized as an internal or external command, operable program or batch file.

Solution

  1. Verify that the program is actually installed.
  2. Check that the program path is included in the PATH system environment variable.
# Check PATH
$env:PATH -split ';'

# Check Ollama path
Get-Command ollama -ErrorAction SilentlyContinue
  1. If you modified PATH, restart AIRGAP Studio for the changes to take effect.

Korean Text Encoding Issues

Symptoms

Korean characters appear garbled in the terminal, or Korean filenames are not recognized.

Solution

PowerShell Encoding Settings

# Change output encoding to UTF-8
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

To avoid entering these commands every time, add them to your PowerShell profile.

# Open profile file (create if it doesn't exist)
if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}
notepad $PROFILE

Add the two encoding settings lines to the profile file and save.

Terminal Encoding Settings

You can also specify encoding in AIRGAP Studio settings.

{
  "terminal.integrated.defaultProfile.windows": "PowerShell",
  "terminal.integrated.env.windows": {
    "PYTHONIOENCODING": "utf-8"
  }
}

Terminal Not Opening

Solution

  1. Run Ctrl+Shift+P > Terminal: Create New Terminal.
  2. Check the default shell configuration.
  3. Verify that the shell executable path is correct.
{
  "terminal.integrated.profiles.windows": {
    "PowerShell": {
      "source": "PowerShell",
      "icon": "terminal-powershell"
    }
  }
}
  1. If the issue persists, try running AIRGAP Studio as administrator.