Windows Setup

Source: https://pi.dev/docs/latest/windows

Pi requires a bash shell on Windows. It checks, in order:

1. Custom path from ~/.pi/agent/settings.json
2. Git Bash (C:\Program Files\Git\bin\bash.exe)
3. bash.exe on PATH (Cygwin, MSYS2, WSL)

Git for Windows is sufficient for most users.

Custom Shell Path

{
  "shellPath": "C:\\cygwin64\\bin\\bash.exe"
}

The value is JSON, so each literal backslash in the Windows path must be doubled.

Related Windows notes: Ctrl+Enter for multi-line input, Alt+V to paste images, app.suspend has no default binding (references/keybindings.md), and Alt+Enter must be remapped away from fullscreen (references/terminal-setup.md).