Install Paneflow and run your first multi-pane agent workspace in under two minutes.

Paneflow is a cross-platform terminal multiplexer built for agentic CLI workflows - Claude Code, Codex, OpenCode, and any other agent that speaks plain shell. Split panes, persistent sessions, dev-server port detection, and zero-config theming, all in a native GPU-accelerated app that boots in under 200 ms.

macOS - Apple Silicon

Download .dmg (0.2.16)

Linux - x86_64

Download AppImage (0.2.16)

Paneflow ships signed binaries for macOS (notarized .dmg, Apple Silicon) and Linux (.deb, AppImage, tarball, x86_64 and ARM64). The buttons above grab the recommended format for each OS; the per-OS guides below cover every other path.

Install for your platform

Install on macOS

Signed and notarized .dmg for Apple Silicon. Gatekeeper-clean on first launch, Homebrew tap in flight.

Install on Linux

.deb, AppImage, or tarball. Works on every modern distribution, Wayland and X11, x86_64 and ARM64.

Compare install paths

Side-by-side overview of every supported install format, dependency footprint, and PATH integration.

First steps after install

Your first session

Open a workspace, split panes, run an agent, and learn the muscle memory.

Keybindings

The default keymap, the Terminal context, and how to remap any action in paneflow.json.

Layouts

Even, main-vertical, tiled - and how to author your own with the layout tree.

Themes

Bundled themes, 35 terminal slots, and hot-reload from paneflow.json.

Configuration

Where paneflow.json lives, what every key does, and the JSON schema.

Troubleshooting

Vulkan on Linux, Gatekeeper on macOS, PATH, fonts, fallback flags.

What runs on the inside

Pure Rust + GPUI - the same framework Zed runs on.
Native VT emulation via alacritty_terminal (crates.io 0.26).
Native PTY via portable-pty - same code path on Linux and macOS.
JSON-RPC IPC at $XDG_RUNTIME_DIR/paneflow/paneflow.sock for headless scripting.
Sub-200 ms cold start and sub-4 ms keystroke-to-pixel on the latency probe.

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 (built-in)

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 this documentation, detect your OS, and walk the install one confirmation at a time.

Install Paneflow on my machine.

1. Read https://paneflow.dev/llms.txt to discover the install guides.
2. Detect my OS and architecture (uname -a on Linux/macOS).
3. Fetch the matching install page as raw markdown by appending .md to its URL (e.g. https://paneflow.dev/docs/installation/linux.md).
4. Pick the recommended format for my system: AppImage for Linux, .dmg for macOS. If two paths look equally good, ask me before picking.
5. Show me every command you plan to run BEFORE executing it. Wait for my confirmation. Never run sudo without explicit approval.
6. After install, verify with `paneflow --version` and tell me how to launch it.

File a bug or feature request on GitHub Issues.
Browse all release artifacts on the download page.
Source code: github.com/ArthurDEV44/paneflow.

Get started