# Download

Install Pane with the OS-specific shell installer. It installs or updates the desktop app, which also puts the [`runpane` CLI](/docs/runpane-cli) on your `PATH`.

<OsInstall />

> **Warning:** You also need git ([Git for Windows](https://git-scm.com/downloads/win) on Windows) and at least one agent CLI, such as [Claude Code](/docs/quick-starts/claude-code) or [Codex](/docs/quick-starts/codex).

Want Pane on your phone? The iPhone app is a public beta: [try the iOS beta in TestFlight](https://testflight.apple.com/join/eKJmnzXF), then pair it with the QR code from your computer. Steps are in [Pane on your phone](/docs/phone#ios-app-beta).

## Package-Manager Alternatives

If you already have Node or Python, run the `runpane` package once for a guided setup:

<PackageInstall />

For a persistent `runpane` command (only if you skipped the desktop app):

```bash
npm i -g runpane
runpane setup
```

```bash
python -m pip install runpane
python -m runpane setup
```

The npm package needs Node 22.23.4+, 24.22.1+ or 26.12.1+. See [runpane CLI](/docs/runpane-cli#install) for pnpm, pipx, uvx, explicit daemon commands, and dry-run options.

<a id="phones-other-computers-and-remote-vms"></a>

## Remote VMs and Servers

For a headless VM or server, run the remote shell installer on the host:

<RemoteInstall />

If you want the guided CLI instead, choose **Set up a remote host**:

<RemotePackageInstall />

It prints the same kind of connection code. See [Tailscale and Remote VMs](/docs/remote-daemon) for the full flow.

<a id="nightly-builds"></a>

## Nightly Remote Hosts

These commands set up a [Remote Pane](/docs/remote-daemon) host on the nightly channel, which ships changes before stable. Not recommended for daily use. The desktop app follows stable releases only.

<NightlyInstall />

## Direct Download

Download a binary directly from [GitHub Releases](https://github.com/greenfield-inc/Pane/releases/latest).

- **macOS**: separate Apple Silicon (`arm64`) and Intel (`x64`) builds, as `.dmg` and `.zip`. Pick the one that matches your Mac.
- **Windows**: x64 and ARM64 `.exe` installers
- **Linux**: x64 and ARM64 `.AppImage` and `.deb` packages

<Toggle title="macOS: Gatekeeper warning">

Release builds for macOS are signed and notarized, so they should open without a warning. If macOS still blocks the app, open **System Settings → Privacy & Security** and click **Open Anyway** next to the Pane entry. You only do this once.

</Toggle>

<Toggle title="Windows: SmartScreen warning">

The Windows installer isn't code-signed yet, so SmartScreen may warn you. Click **More info**, then **Run anyway**. You only see this on install.

</Toggle>

<Toggle title="Building from source">

Clone the repository from [github.com/greenfield-inc/Pane](https://github.com/greenfield-inc/Pane), then:

```bash
pnpm run setup
PANE_DIR=~/.pane_test pnpm dev
```

`PANE_DIR` keeps the dev build away from your real `~/.pane` data.

You need Node.js 22.23.4+, 24.22.1+ or 26.12.1+, and pnpm.

</Toggle>
