# Getting Started

Install Pane, then create your first agent session.

## Step 0: 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).

## Step 1: 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.

## Step 2: Create a pane

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

<PaneCreator />

## Step 3: You're in a terminal

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

<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 — 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 <KeyCombo keys={["⌘", "↑"]} /> and <KeyCombo keys={["⌘", "↓"]} />, or jump straight to one with <KeyCombo keys={["⌘", "1-9"]} />. Inside a pane, <KeyCombo keys={["⌘", "A"]} /> and <KeyCombo keys={["⌘", "D"]} /> move between its tabs.

<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 falls back to `origin/main`, then `origin/master`. 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. You can also just click **+** again after the first pane is created.

</Toggle>

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

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

<ConnectionFlow />

See [Remote VM Setup](/docs/remote-daemon) for the full walkthrough.

</Toggle>