Get started

Install Paneflow, split your first pane, and launch a coding agent.

Last updated on July 2, 2026

Paneflow is a local Rust/GPUI workspace for supervising CLI coding agents in real terminal panes. Use it to run Claude Code, Codex, OpenCode, Gemini, or any shell command side by side while keeping workspaces, branches, sessions, diffs, and pane context visible.

Native builds ship for Linux (x86_64 and ARM64), macOS (Apple Silicon), and Windows (x86_64). Release users do not need Rust.

Start Paneflow

Download and install Paneflow

Grab the signed build for your OS. The buttons pick the recommended format; the OS guides cover every other install path.

Download for macOS (Apple Silicon)

Need a different operating system?

Download for Linux (x86_64)Download for Windows (x86_64)All Linux distributions (.deb, tarball, ARM64)

homebrew

brew install --cask arthurdev44/paneflow/paneflow

Need a different path? Read the Linux guide, the macOS guide, the Windows guide, or compare every install format.

Open the app

Run Paneflow from a terminal, or open it from Spotlight, Applications, the Start menu, or your launcher:

bash

paneflow

Paneflow opens with one workspace and one shell pane, named after the directory you launched from. There is no sign-in step: no Paneflow account, no hosted runtime, and no Paneflow API key. Desktop telemetry is off unless you explicitly accept it on first launch.

Window does not render? Paneflow needs Vulkan on Linux, Metal on macOS, and DirectX on Windows. Start with the matching OS install guide if the first launch fails to open.

Split your first pane

Split the focused pane and move focus with the default shortcuts:

Cmd/Ctrl+Shift+D - split horizontally.
Cmd/Ctrl+Shift+E - split vertically.
Alt+Arrow - move focus across the pane tree.
Cmd/Ctrl+Shift+N - add another workspace.

Cmd is used on macOS. Ctrl is used on Linux and Windows. Each new pane starts a fresh shell in the same working directory.

Run your first agent

Paneflow launches any binary in a pane. In a fresh pane, start the agent you already use:

bash

claude     # Anthropic's Claude Code
codex      # OpenAI's Codex CLI
opencode   # OpenCode

Known agents get richer status when their hooks or shims are available. Unknown CLIs still run as normal terminal panes. Paneflow does not select models or proxy provider traffic; each agent keeps using its own account, API, and network path.

System requirements

Platform	Minimum	GPU
Linux	glibc 2.31+ (Ubuntu 20.04, Debian 11, Fedora 34)	Vulkan loader (`libvulkan1` / `vulkan-loader`)
macOS	13 Ventura, Apple Silicon	Metal
Windows	10 (1809+) or 11, x86_64	DirectX 11

On Windows, prefer PowerShell or Git Bash for panes where current working directory tracking matters. Legacy cmd.exe does not emit the OSC 7 sequence Paneflow uses for CWD-aware features.

Install with your AI agent

Already running Claude Code, Codex, OpenCode, or another agentic CLI? Hand the install over. The prompt below tells your agent to read the raw Markdown docs, detect your OS, and ask before running commands.

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

Features

Understand panes, agent status, workspaces, sessions, MCP context, and worktree review.

Configuration

Find paneflow.json, set defaults, and inspect the JSON schema.

Shortcuts and actions

Review default shortcuts and the action names you can bind in paneflow.json.

Troubleshooting

Fix launch, GPU, PATH, config, signing, and shell issues.

Need to compare tools? Use the comparison hub. Need to report a bug? Open an issue on GitHub.