# Fly with Pane

Pane is packed with quality-of-life details that compound fast. Each one saves a few seconds. Together, they change how you work.

## Status Dots

<StatusDots />

Every agent tab gets a dot that tells you what it's doing:

- **Red, pulsing**: it's waiting on you.
- **Blue, pulsing**: it's working.
- **Blue**: it finished while you were looking elsewhere.
- **Green**: it's idle.

Plain shells don't get a dot. The dots roll up to the pane and the project, so you know what needs you without switching to check.

## Drag and Drop

<DragDropZone />

Drop any file up to 50 MB onto a terminal and Pane types its path for you. No more hunting for paths. In a WSL pane the path is converted to a Linux path, and on a remote host the file is uploaded there first.

## Paste Screenshots

Paste a screenshot straight into an agent's terminal. Pane saves the image and types its path, so Claude Code or Codex can look at it. In a WSL pane, Pane saves it inside the distro.

## Terminal Popover

<TerminalPopover />

Select text in a terminal, like an error, a file path or a URL, and a small menu appears. Copy it, open a link in Pane's browser or your own, or show a file in your file manager.

## Isolated Ports

<PortIsolation />

Each pane gets its own block of 10 ports, in `PANE_PORT`. Point your run script at it once, `PORT=$PANE_PORT pnpm dev`, and three panes run three dev servers with zero collisions.

## Terminal Patches for Agentic CLIs

Claude Code has a known annoyance: while it redraws, it clears the screen, which yanks you to the top while you're reading. Pane strips those clears, so you stay where you were.

We patch several other xterm.js behaviors that affect agentic CLIs - the same terminal engine VS Code uses, tuned for agent workflows.

<Toggle title="What we patch">

- **Scroll position**: Claude Code's redraw clears no longer yank you around while you read.
- **Paste**: a paste lands once, not twice, on Windows and WSL.
- **Keys**: modifier keys work through WSL, and programs that ask for precise key reporting get the Kitty keyboard protocol.

These patches apply automatically. No configuration needed.

</Toggle>

## Built-in Changes & Files

Review every change your agents make without leaving Pane. Press <KeyCombo keys={["⌘", "⇧", "B"]} /> for the side panel: **Changes** lists every touched file, and each diff opens as a tab, split or unified. **Files** browses the worktree, and files open in an editor tab with syntax highlighting and auto-save.

→ [See Tabs](/docs/panels)

## Inline Terminal Images

Terminals in Pane render images inline, using the Sixel and iTerm2 image formats. When an agent produces a chart, diagram, or screenshot, it shows directly in the terminal output. No separate viewer needed.

## Pane Name in Title Bar

The active pane's name shows in the window title bar on macOS, Windows, and Linux. When you have multiple Pane windows open, the OS taskbar and window switcher show which pane is which.

## Open PRs in Browser

After pushing a branch, Pane can open the pull request directly in a browser tab. No need to switch to GitHub manually.

## In-App Feedback

Hit a bug or have a suggestion? Pane has a built-in GitHub feedback flow. File an issue directly from inside the app without leaving your workspace.

## Leaderboard

Pane has an opt-in usage leaderboard. Joining is up to you. Once you join, Pane sends your usage totals when the app opens: your GitHub username (or a hashed git email), token counts, message count, estimated cost and totals per model. Never prompts or file paths. You can send now or leave from the Leaderboard tab.

## What Else

- **Cross-terminal context**: type `@` to pull output from another terminal in the same pane into the one you're in. → [Keyboard Shortcuts](/docs/keyboard-shortcuts#-terminal-reference)
- **Snippet shortcuts**: `⌘⌥letter` on macOS or `Ctrl+Alt+letter` on Windows and Linux types text you saved into the focused terminal. Prompt templates, review instructions, debug commands, one keystroke each. → [Keyboard Shortcuts](/docs/keyboard-shortcuts#terminal-shortcuts)
- **Secrets sync automatically**: `.env` and other gitignored files you pick copy into every new worktree. Your pane is ready to run the moment it's created. → [Configuration](/docs/configuration#worktree-file-sync)
- **Upload, refresh, jump to top or bottom**: buttons at the top-right of every terminal. If a terminal looks stuck, refresh fixes it without losing it. → [Settings](/docs/settings#terminal)
- **Usage & Limits**: see token counts and cost for Claude Code and Codex, plus Codex rate limits. Track spending per pane. → [Usage & Limits](/docs/usage)
