# Windows Support

Voxcode supports Windows environments. The Windows Terminal app is strongly recommended.

## Requirements

- **Windows 10 (build 1903+) or Windows 11**
- **Windows Terminal** — install from the Microsoft Store or `winget install Microsoft.WindowsTerminal`
- **Node.js >= 22.19.0** — download from [nodejs.org](https://nodejs.org) or use `winget install OpenJS.NodeJS.LTS`
- **npm >= 10** — ships with Node.js

## Setup

```powershell
# Verify
node -v
npm -v

# Install Voxcode
npm i -g @voxcode-dev/voxcode

# Start a session
vox
```

## Recommendations

- **Use Windows Terminal** — it has the best true color, Unicode, and keybinding support.
- **Use PowerShell** — avoid CMD; PowerShell handles ANSI escape sequences and UTF-8 correctly.
- **Keep Node.js and npm updated** — older versions may have compatibility issues.
- **If using WSL**, install Voxcode inside the WSL environment for Linux-like toolchains.

## Environment Variables in PowerShell

```powershell
$env:ANTHROPIC_API_KEY = "your-key"
$env:VOXCODE_TELEMETRY = "0"
```

For permanent config, add to your PowerShell profile (`$PROFILE`).

## Troubleshooting

- **Unicode/garbled output**: set `$OutputEncoding = [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new()`
- **ANSI colors not showing**: ensure Windows Terminal is the host; enable `VT processing` in legacy consoles
- **Path too long**: use a shorter project path or enable long path support in Windows 10/11
- **Slow startup**: check antivirus exclusions for Node.js and npm

If needed, use WSL for Linux-like toolchains where Voxcode's TUI will have the most consistent behavior.
