# Windows and WSL

Pane is a native Windows app. It isn't a port, and you don't need WSL to use it. But if your code lives in WSL, Pane works there too. Your agents run in the distro, with your Linux tools, and Pane stays a normal Windows window.

Without WSL, agents run in Git Bash or PowerShell, which works for most repos. Use WSL when your scripts expect Linux or you want Cursor Agent.

## Install on Windows

1. Download the `.exe` for your machine from [Download](/docs/download). There's an **x64** build and an **ARM64** build for Surface and other Snapdragon PCs.
2. Run the installer. You pick where it goes, and it adds Start menu and desktop shortcuts.
3. The installer isn't code-signed yet, so SmartScreen may warn you. Click **More info**, then **Run anyway**.

You need [Git for Windows](https://git-scm.com/downloads/win) and at least one agent CLI. Install the GitHub CLI (`gh`) too if you want PR status.

### Pick your shell

Pane auto-detects your shell and prefers Git Bash. Want something else? Open **Settings → Terminal → Windows shell** and pick Git Bash, PowerShell 7, Windows PowerShell or Command Prompt.

## Use a repo inside WSL

Keep the repo on the Linux side and add it to Pane by its WSL path:

1. Click the **+** icon in the sidebar, or press <KeyCombo keys={["Ctrl", "Shift", "N"]} />.
2. Pick the folder through `\\wsl$\` (or `\\wsl.localhost\`), for example `\\wsl$\Ubuntu\home\you\code\my-app`.
3. Create a [pane](/docs/panes-and-worktrees) like normal.

Pane sees the WSL path and handles the rest:

- **Terminals and agents run in the distro.** Every tab in that pane opens a Linux shell, with your Linux `node`, `git`, `python` and agent CLIs.
- **Worktrees stay on the Linux filesystem.** By default Pane puts them in a `worktrees` folder inside the repo, so git stays fast.
- **Pane's variables come with you.** `PANE_PORT`, `PANE_WORKSPACE_PATH` and the others reach WSL shells too.
- **Pasted images land in the distro**, so an agent in WSL can read them.
- **File watching just works.** Pane raises WSL's inotify limits on startup so big repos don't run out of watches.

Install your agents inside the distro, not on Windows. Check that Pane can find one with the [`runpane` CLI](/docs/runpane-cli): `runpane agents doctor --agent claude` (or `--agent codex`). It checks inside the distro of the repo you have open.

## Agents in WSL

| Agent | Native Windows repo | WSL repo |
|-------|---------------------|----------|
| Claude Code | yes | yes |
| Codex | yes | yes |
| [Cursor](/docs/quick-starts/cursor-agent) | no | yes |
| OpenCode | yes | yes |
| Pi | yes | yes |
| Any other CLI | yes | yes, runs in the distro |

### MCP and skills inside WSL

Pane registers its [MCP server](/docs/mcp) inside every WSL distro where you've saved a repo, for Claude Code, Codex and Cursor. It installs its agent skills there too. Agents reach the Windows app through WSL interop, so you don't install anything extra.

## Run a Session in WSL

A [Session](/docs/sessions) can run its agent in a WSL distro:

1. Click **+** next to **Sessions**.
2. Under the agent picker, set **Run agent in** to your distro. Windows is the default.
3. Create the Session.

The Session remembers its distro after restarts. Its `runpane` commands still reach the Windows app, so it can manage every pane you have.

## Use WSL as a remote host

You can also run Pane's host inside WSL and connect to it with [Remote Pane](/docs/remote-daemon). Use that when you want agents to keep running somewhere you can reach from your phone.

## Known limits

- **WSL needs its default setup.** Pane expects Windows drives at `/mnt/c` and WSL interop turned on. A custom `[automount] root` in `wsl.conf` isn't supported. In WSL shells you open yourself, `runpane` comes from the Windows `PATH`, so leave `appendWindowsPath` on.
- **Usage tracking doesn't see WSL agents yet.** [Usage & Limits](/docs/usage) reads Claude Code and Codex logs on the Windows side only.

## Related

- [Download](/docs/download)
- [Custom agents](/docs/custom-agents): run any CLI, including in WSL
- [Troubleshooting](/docs/troubleshooting)
