Install Pane, then create your first agent session.

Step 0: Install Pane

Run the OS-specific install command in your terminal:

curl -fsSL https://runpane.com/install.sh | sh

Or download directly from GitHub

If you prefer the guided runpane CLI or need package-manager runners, see Download.

Step 1: Add a project

Click the + icon in the sidebar or press ⌘+⇧+N (macOS) / Ctrl+⇧+N (Windows/Linux), then select a git repository folder. Pane indexes the repo and shows it in the sidebar.

Step 2: Create a pane

Click + next to your project, type a feature name, and click Create. Pane creates an isolated git worktree automatically.

Create Pane

Base branch

Feature name

Creates a new git worktree with an isolated branch

Step 3: You’re in a terminal

Your new pane opens directly to a terminal. Run any CLI agent — no extra setup.

Terminal

$ claude
Welcome to Claude Code. Type / for commands.
 
$ Build a login page with email and password
Created src/components/LoginPage.tsx
Updated src/App.tsx
$ 

What just happened

Pane created a git worktree — a fully isolated copy of your repo on its own branch. Every pane gets its own working directory, so agents never overwrite each other’s work.

Switch between open panes with ⌘+A (previous) and ⌘+D (next).

Pane defaults to origin/main. If your team uses a different base (e.g. origin/develop or origin/staging), change it in the Base branch dropdown when creating a pane.

Each project supports a custom system prompt (injected into the agent on startup) and a run script (executed before the agent starts). Configure both in Settings → Project. See Configuration for details.

Use the Count field in the Create Pane dialog to spin up several isolated worktrees in one click. Each gets a numbered branch based on the feature name you enter. You can also just click + again after the first pane is created.

Run agents on a remote machine while keeping the Pane UI on your laptop.

Setup Flow

Set up the host in Pane

Host machine → Settings > Remote Pane → Set Up This Machine

Copy the code

Create and copy the pane-remote:// connection code

Import code on client

Desktop Pane Settings > Remote Pane or runpane.com/app → Paste code

Create first remote pane

Click + next to your project

See Remote VM Setup for the full walkthrough.