# Getting Started

<a id="step-0-install-pane"></a>

## Step 1: Install Pane

Run the OS-specific install command in your terminal:

<OsInstall />

If you prefer the guided `runpane` CLI or need package-manager runners, see [Download](/docs/download).

<a id="step-1-add-a-project"></a>

## Step 2: Add a project

Click the **+** icon in the sidebar or press <KeyCombo keys={["⌘", "⇧", "N"]} /> (macOS) / <KeyCombo keys={["Ctrl", "⇧", "N"]} /> (Windows/Linux), then select a git repository folder. Pane indexes the repo and shows it in the sidebar.

<a id="step-2-create-a-pane"></a>

## Step 3: Create a pane

Click **+** next to your project, type a feature name, and click **Create**.

<PaneCreator />

<a id="step-3-youre-in-a-terminal"></a>

## Step 4: Start an agent

Your new pane opens to a terminal. Run any agent you have installed, like `claude` or `codex`. Don't have one yet? Follow a [Quick Start](/docs/quick-starts/claude-code).

<TerminalPreview lines={[
  { type: "command", text: "claude" },
  { type: "output", text: "Welcome to Claude Code. Type / for commands." },
  { type: "output", text: "" },
  { type: "command", text: "Build a login page with email and password" },
  { type: "success", text: "Created src/components/LoginPage.tsx" },
  { type: "success", text: "Updated src/App.tsx" },
]} />

## What just happened

Pane created a [git worktree](/docs/panes-and-worktrees): a separate copy of your repo on its own branch. Every pane gets its own, so agents never overwrite each other's work.

Switch between open panes with <KeyCombo keys={["⌘", "↑"]} /> and <KeyCombo keys={["⌘", "↓"]} />, or jump straight to one with <KeyCombo keys={["⌘", "1-9"]} />. Inside a pane, <KeyCombo keys={["⌘", "⇧", "["]} /> and <KeyCombo keys={["⌘", "⇧", "]"]} /> move between its tabs (<KeyCombo keys={["Ctrl", "PageUp"]} /> and <KeyCombo keys={["Ctrl", "PageDown"]} /> on Windows and Linux).

<Toggle title="Adjusting the base branch">

Pane uses your remote's default branch, the one `origin/HEAD` points to. If that's not set, it tries `origin/main`, `origin/master`, `main` and `master`, in that order. Working off a different base, like `origin/develop`? Pick it in the **Base branch** dropdown when you create the pane.

</Toggle>

<Toggle title="Project settings: system prompt and run script">

Each project can have a system prompt (added to every Claude Code pane), a setup script (runs when a worktree is created), a run script (the Play button) and an archive script. Open the project's menu in the sidebar and choose **Project settings**. See [Configuration](/docs/configuration) for details.

</Toggle>

<Toggle title="Creating multiple panes at once">

Open **Advanced** in the New Pane dialog and slide **Panes** up to 5 to spin up several isolated worktrees in one click. Each gets a numbered branch based on the name you enter.

</Toggle>

<Toggle title="Getting started with Remote Pane">

Use Pane from your phone, a phone's browser or another computer, on any network. No account, no Tailscale, no port forwarding. On an iPhone, [try the iOS beta in TestFlight](https://testflight.apple.com/join/eKJmnzXF).

<ConnectionFlow />

The phone shows your sessions a few seconds later. The code works once and expires after 10 minutes. To link another computer, open **Add a device → Computer** and send it the link. Each linked computer lists the others under **Settings → Remote Access → Computers**. See [Pane on your phone](/docs/phone) for the details.

Tailscale still works if you use it, and it's how headless VMs connect. See [Tailscale and Remote VMs](/docs/remote-daemon).

</Toggle>
