Pane

<p align="center"> <img src="frontend/src/assets/pane-logo.png" alt="Pane" width="120" height="120"> </p> <p align="center"> <strong>Run any coding agent, on any OS, from desktop <a href="#remote-pane">or phone</a>.</strong><br> <em>just terminals. no abstractions.</em> </p> <div align="center"> <a href="https://runpane.com" title="Click on this image to see more themes and demo"> <img src="assets/readme-remote-pane.png" alt="Pane desktop app and Remote Pane mobile browser app" title="Pane desktop app and Remote Pane mobile browser app" width="100%"> </a>

Appearance follows your OS — see Appearance.

<br />

Made possible by our amazing contributors

<a href="https://github.com/greenfield-inc/Pane/graphs/contributors"> <img src="https://contrib.rocks/image?repo=greenfield-inc/Pane" alt="Pane contributors"> </a>

_{<a href="./CONTRIBUTING.md">Join them</a> and help make Pane better.}

<br /> <br />

Quick install (recommended)

_{Mac / Linux}<br />

<pre><code>curl -fsSL https://runpane.com/install.sh | sh</code></pre>

_{Windows (PowerShell)}<br />

<pre><code>irm https://runpane.com/install.ps1 | iex</code></pre>

_{<em>Bypasses the macOS Gatekeeper / Windows SmartScreen prompts on direct downloads.</em>}

<br /> <br />

_{or download the installer directly}<br /> <br />

<a href="https://runpane.com/api/download?platform=mac&source=readme"> <img src="https://img.shields.io/badge/Download_for_macOS-000?style=for-the-badge&logo=apple&logoColor=white" height="40" alt="Download for macOS"> </a> <a href="https://runpane.com/api/download?platform=windows&source=readme"> <img src="https://img.shields.io/badge/Download_for_Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white" height="40" alt="Download for Windows"> </a> <a href="https://runpane.com/api/download?platform=linux&source=readme"> <img src="https://img.shields.io/badge/Download_for_Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black" height="40" alt="Download for Linux"> </a> <br /> <br /> <details> <summary>_{Other install methods: npx, pnpm, and pipx}</summary> <br /> <pre><code># Guided setup via npm npx --yes runpane@latest # pnpm one-shot pnpm dlx runpane@latest # Python tools one-shot pipx run runpane # Persistent npm install npm i -g runpane runpane setup</code></pre> </details> <br /> <br />

Installation · What Flying Feels Like · Remote Pane · Pane Chat · Agent-Operable CLI · Keyboard Shortcuts · Building from Source

</div>

Not an IDE. Not a terminal emulator. Vim for agent management.

Pane manages AI coding agents without replacing them. If it runs in a terminal, it runs in Pane — instantly, with zero integration. Claude Code, Codex, Cursor Agent, Aider, Goose, or any CLI tool. No plugins, no SDK, no waiting for support.

---

Why Pane Exists

AI coding agents are incredible. Claude Code can work autonomously for hours. Codex can ship features end-to-end. Aider can refactor entire modules. The models are not the bottleneck.

The way you interact with them is.

Managing AI agents right now feels like air traffic control with a walkie-talkie. You're juggling terminal windows. Copy-pasting between tabs. Losing track of which agent is on which branch. Alt-tabbing between your diff viewer, your terminal, your git client, and your editor. The agents are fast — but your tools make you slow.

And then there's git worktrees. Everyone agrees worktrees are the right way to run parallel agents — isolated branches, no conflicts, clean separation. But actually using them? It's miserable. git worktree add, git worktree remove, remembering paths, tracking which worktree is on which branch, cleaning up stale ones, rebasing back to main, squashing commits before merging. Even experienced developers fumble the workflow. It's powerful infrastructure with terrible UX.

Pane makes worktrees invisible. You create a session, Pane creates the worktree. You delete a session, Pane cleans it up. You hit a shortcut, Pane rebases from main. You never type git worktree again. All the isolation benefits, none of the pain.

---

What Flying Feels Like

Each of these is a small thing. Together they compound fast.

| Feature | | | |---|---|---| | Pane Chat | A global orchestrator terminal that starts in the Pane data directory, loads local Pane orchestration skills, and can coordinate Claude, Codex, or Cursor across repositories, panes, tabs, worktrees, and review loops. | <a href="#pane-chat">Details</a> | | Remote Pane | Run panes, worktrees, terminals, files, git state, and approval prompts on a self-hosted remote machine while controlling them from desktop Pane or the browser app at runpane.com/app. | <a href="#remote-pane">Setup</a> | | Agent-Operable CLI | Pane ships with runpane agent-context, runpane repos add, and runpane panes create, so a coding agent can discover Pane's command schema, register a repo, and open follow-up panes for issues or tasks. Claude Code, Codex, and Cursor get the same commands as MCP tools. | Contract · MCP | | @mention Terminals | Type @ in any terminal to pull the last 500 lines from another pane's terminal directly into your context, no copy-paste required. | <img src="images/qol-at-mention.png" alt="Cross-terminal @mention picker" width="420"> | | Clipboard Shortcuts | Ctrl+Alt+[key] pastes any saved text snippet instantly, so your most-used prompts are one keystroke away forever. | <img src="images/qol-clipboard.png" alt="Terminal clipboard shortcuts popover" width="280"> | | Terminal Popover | Highlight any text in a terminal and an intelligent popover offers the right action: copy, open in browser, or show in explorer. | <img src="images/qol-terminal-popover.png" alt="Terminal text selection popover" width="420"> | | Built-in Browser | Preview any URL in a tab next to your terminals so every pane can see its own running dev server without alt-tabbing. | <img src="images/qol-browser.png" alt="Built-in browser tab previewing a local dev server" width="420"> | | Resource Manager | Built-in CPU and memory monitor broken down per pane and per process, so you can catch a runaway agent before it eats your laptop. | <img src="images/qol-resource-manager.png" alt="Built-in resource manager" width="420"> | | Status Cues | Every AI pane reports its state at a glance — a red dot when an agent is blocked waiting on your approval, an amber pulse while it works, and a "done" cue when it finishes while you're looking elsewhere. The same rollup colors the project dots and pane tabs, so a whole screen of parallel agents reads in one glance. | <img src="images/qol-status-dots.png" alt="Session agent status dots: blocked, working, done" width="280"> | | Jump + Refresh | Jump to top, jump to bottom, or hard-refresh any terminal from the toolbar to unstick a frozen state in one click. | <img src="images/qol-jump-refresh.png" alt="Terminal jump and refresh controls" width="120"> | | Auto Secrets Copy | Every pane automatically mirrors .env files and secrets from your root project so your worktree is runnable the moment it's created. | | | Isolated Ports | Each pane runs on its own port range automatically, so you can spin up five dev servers in parallel without a single conflict. | | | Terminal Rendering Patches | Claude Code's scroll-jump bug (long conversations snapping to top when you scroll up) is fixed here, even though it's still broken in Claude Code itself. | | | Drag and Drop | Drop any file up to 50MB into a terminal and it lands exactly where you need it. | |

---

Remote Pane

Run agents on a VM, WSL box, home server, desktop, Mac mini, or cloud machine while you keep the Pane UI on your laptop or phone. Remote Pane is self-hosted and open source: the host machine runs the repos, terminals, git state, files, agent credentials, and compute; the client just connects with a pane-remote://... code.

The easiest setup path is in the app:

1. Install Pane normally on the machine that should host your projects and agents.
2. Open Settings > Remote Pane on that host machine.
3. Set it up as a remote host and copy the generated pane-remote://... connection code.
4. On another desktop, open Pane, go to Settings > Remote Pane, paste the code, and connect.
5. On a phone or tablet, open runpane.com/app, paste the same code, and connect.

For a headless VM or server, run the guided setup in its terminal:

npx --yes runpane@latest

Choose Set up a remote host, give it a name, and follow the Tailscale login prompts. Paste the printed connection code into Pane or runpane.com/app on another device signed into the same Tailscale network.

To skip the menu and run interactive remote setup directly:

npx --yes runpane@latest install daemon --interactive-tailscale-setup --auto-listen-port

pnpm:

pnpm dlx runpane@latest

Python tools:

pipx run runpane

Use SSH instead of Tailscale:

npx --yes runpane@latest install daemon --label "My Server" --prefer-tunnel ssh

The hosted shell installers remain available:

curl -fsSL https://runpane.com/install-remote.sh | sh -s -- --label "My Server"

Windows PowerShell:

& ([scriptblock]::Create((irm https://runpane.com/install-remote.ps1))) -Label "My Server"

The CLI setup command prints the same connection code and, for SSH mode, the forwarding command. See the Remote Daemon docs for the full step-by-step setup, mobile install instructions, API key notes, and security model.

---

Pane Chat

Pane Chat is the global orchestrator terminal for a Pane workspace. It is not tied to a repository or worktree. It starts from the Pane data directory, reads a generated local runtime context, and uses the runpane CLI to inspect and operate the workspace.

Use it for the work that spans panes:

Add this repo, create three worktree panes for the next features, start Codex in each one, and keep a separate review tab ready for every PR.

Pane Chat keeps the human discussion at the orchestrator level, captures work as tickets or briefs, then hands authorized implementation to Claude, Codex, or Cursor agents in Panes through RunPane.

The prompt stays small because Pane ships its skills and writes them into the Pane data directory on every start:

• skills/pane-chat/pane-orchestrator/SKILL.md: the Pane Chat entry point (also in `.claude/skill