Skip to content
PaneflowPaneflow
Docs

Get started

Install Paneflow, open a terminal pane, and run your first coding agent. Review its changes and keep its session running when you close the app.

Paneflow is a native terminal multiplexer for coding agents. Run Claude Code, Codex, OpenCode, Gemini, or shell commands in separate panes, follow their activity, and review their changes in one interface.

Paneflow is free and open source. It runs on Linux (x86_64 and ARM64), macOS (Apple Silicon), and Windows (x86_64). You do not need Rust to install it.

Paneflow with Claude Code in the left pane, source code in the center, and a review agent in the right pane.

Run your first agent

1.Download and install Paneflow

Choose the download for your operating system, then follow its installation guide. On macOS, you can also install with Homebrew.

Download Paneflow

Need a different operating system?

Download for macOS (Apple Silicon)Download for Linux (x86_64)Download for Windows (x86_64)All Linux distributions (.deb, tarball, ARM64)
homebrew
brew install --cask arthjean/paneflow/paneflow

Read the Linux installation guide, macOS installation guide, or Windows installation guide. For other packages or architectures, compare installation formats.

2.Open Paneflow

Open Paneflow from your application launcher, Spotlight, the Applications folder, or the Start menu. You can also run it from a terminal in your project directory:

Terminal
paneflow

On first launch, Paneflow opens a workspace with a terminal pane. You do not need a Paneflow account or API key. Telemetry is off by default and only enabled with your consent.

Paneflow does not open? Check the graphics requirements below and follow the troubleshooting guide. If your terminal cannot find paneflow, follow your operating system's installation guide to make the command available.

3.Split the terminal into panes

Use the default shortcuts to open a second pane and move between panes:

  • Cmd/Ctrl+Shift+D - split horizontally.
  • Cmd/Ctrl+Shift+E - split vertically.
  • Alt+Arrow - move focus between panes.
  • Cmd/Ctrl+Shift+N - open another workspace.

Use Cmd on macOS and Ctrl on Linux and Windows. Each new pane opens a shell in the same working directory.

4.Start an installed agent

Install your agent separately and complete its setup before running it in Paneflow. In a terminal pane, run one of these commands for the agent you use:

Claude Code
claude
Codex
codex
OpenCode
opencode

You can run other CLI agents or shell commands in any pane. Each agent uses its own account and model provider. The activity status Paneflow shows depends on the agent's integration.

To run a second agent alongside the first, start it in another pane.

Review the changes

After an agent edits files, open Changes in the dock to review the active checkout's diff against HEAD. It includes staged and unstaged changes and untracked files. Open Files to read or edit files in the integrated editor.

If tasks need separate working directories, use Git worktrees.

Keep sessions running

When quitting Paneflow, choose Keep sessions running to leave shells and agents running. Reopen the app to reconnect to those sessions.

The machine and session host must stay running. A machine restart or host crash ends those processes. Choose Stop everything and quit to end the sessions when you exit.

System requirements

PlatformSystemGraphics
Linuxx86_64 or ARM64; see the Linux installation guideVulkan loader (libvulkan1 / vulkan-loader) and a compatible GPU driver
macOSmacOS 13 Ventura or later, Apple SiliconMetal
WindowsWindows 10 (1809+) or 11, x86_64DirectX 11

On Windows, use PowerShell or Git Bash to let Paneflow track your current working directory. cmd.exe does not report directory changes through the OSC 7 sequence Paneflow uses.

Install with an AI agent

To have a CLI agent help install Paneflow, copy the prompt below into its conversation. It asks the agent to identify your operating system and architecture, read the matching installation guide, and request your confirmation before running commands or an installer.

Install Paneflow on this machine.

Use https://paneflow.dev/llms.txt to find the current install docs, then fetch the matching raw Markdown guide by appending .md to the install URL. Detect the real OS, architecture, and whether this is native Windows, WSL2, Linux, or macOS.

Follow the recommended path in the matching guide instead of guessing: Homebrew or DMG on macOS, the right Linux format for the distro and use case, MSI on native Windows, and WSL2 only when my files, agents, and toolchains already live inside Linux. If my OS or architecture is unsupported, stop and explain the supported options.

Before running any command or installer action, show exactly what you plan to do and wait for my confirmation. Do not use sudo, run an MSI/DMG, change PATH, or bypass a security prompt unless I explicitly approve it.

After installation, verify with `paneflow --version`, then tell me the shortest reliable way to launch Paneflow on this machine.

Next steps

FeaturesLearn how panes, agent status, sessions, MCP, and worktrees fit together.ConfigurationSet your shell, theme, and defaults in paneflow.json.Shortcuts and actionsFind the default shortcuts and customize their actions.TroubleshootingResolve installation, startup, graphics, and shell problems.

To report a bug, open a GitHub issue.