paneflow
Native terminal multiplexer for coding agents. Persistent sessions, Git worktrees, diffs, and an integrated editor. Built with Rust and GPUI.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/arthjean/paneflow with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/arthjean/paneflow'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/arthjean--paneflow)HTML
<a href="/listings/arthjean--paneflow"><img src="/api/listings/arthjean--paneflow/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Quick start
On macOS:
brew install --cask arthjean/paneflow/paneflow
Everywhere else, take the build for your machine from the [latest release](https://github.com/arthjean/paneflow/releases/latest): Linux builds come as `.AppImage`, `.deb`, and `.rpm`, and the `.msi` installs on Windows. The `.deb` and `.rpm` also register the package repo so later versions arrive through `apt upgrade` or `dnf upgrade`. Every artifact ships a SHA-256 sidecar and a Minisign signature.
[Install docs →](https://paneflow.dev/docs/installation)
2. Install for agents
Let one agent read another agent's pane, so you stop copy-pasting scrollback between them.
paneflow mcp install
This registers a local MCP bridge for supported agents it detects: Claude Code, Codex, Gemini CLI, and OpenCode. Its read tools are `list_panes`, `read_pane`, and `search_pane`, and terminal output comes back wrapped as untrusted data for the reading agent to analyze. Its one write tool, `write_pane`, sends a message to another agent's pane only after you allow that pair of agent sessions in Paneflow.
[Bridge docs →](docs/user/scripting.md)
3. Coordinate a fleet
The `paneflow` CLI lets a script or an agent read, monitor, and control the panes you are watching. For text injection, launch Paneflow with `PANEFLOW_IPC_SCRIPTING=1`; `send` pre-fills text unless you explicitly add `--submit`.
paneflow ps paneflow read cargo-run --lines 100 paneflow send codex-review "Review this branch and report risks" paneflow wait --match claude-impl --pattern "REPORT_DONE" paneflow watch --type ai.stop
`paneflow up` spawns a declarative workspace. `paneflow flow run` executes the steps you define in `flow.toml`: spawn panes or send text, order steps through dependencies, wait for readiness patterns, and capture output. Launching panes with commands or prompts requires `PANEFLOW_IPC_ORCHESTRATION=1` or `PANEFLOW_IPC_SCRIPTING=1`. Prompt submission remains explicit and permission-gated.
[Conductor docs →](docs/user/conductor.md)
4. Configure
Themes, shell, keybindings, and shortcuts live in `~/.paneflow/paneflow.json` (`%USERPROFILE%\.paneflow` on Windows) and hot-reload while the app runs. Everything is also editable in Settings.
[Learn more →](docs/user/configuration.md)
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 111 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <img alt="Paneflow" src="./src-app/assets/icons/paneflow.png" width="36" height="36">
- [](https://github.com/arthjean/paneflow/releases/latest)
- [](LICENSE)
- [](#install)
- [](https://discord.gg/UqGM29Gvat)
- The multiplexer for the agent era.
- Paneflow is a native terminal multiplexer for coding agents. Run agents in parallel, keep their sessions running when you close the app, and review their changes in a native interface.
- Organize projects into tabs and split panes, with several agents in a tab when useful. Work in an existing checkout or create a branch and Git worktree for a separate task. Follow agent activity, see which sessions need attention, and read, interrupt, or take over any terminal. The dock brings together Changes (the checkout's diff against `HEAD`), Files (an integrated editor with Git markers and a file tree), and a terminal.
- Works with any CLI agent - Claude Code, Codex, Gemini, opencode, Pi, Hermes, you name it.
- Paneflow runs locally: agents are ordinary CLI processes in ordinary terminals and connect to their own model providers. Prompts are pre-filled and you press Enter; auto-submit is explicit and gated. Activity tracking depends on the integrations available for each agent.
- Free and open source under [GPL-3.0-or-later](LICENSE). Built with Rust and [Zed's GPUI](https://github.com/zed-industries/zed/tree/main/crates/gpui), using [Ghostty's](https://github.com/ghostty-org/ghostty) `libghostty-vt` terminal engine. Native builds for Linux x86_64 and aarch64, macOS Apple Silicon, and Windows x64.
- [Website →](https://paneflow.dev)
- ## Install
- ### 1. Quick start
- On macOS:
- ```bash
- brew install --cask arthjean/paneflow/paneflow
- ```
- Everywhere else, take the build for your machine from the [latest release](https://github.com/arthjean/paneflow/releases/latest): Linux builds come as `.AppImage`, `.deb`, and `.rpm`, and the `.msi` installs on Windows. The `.deb` and `.rpm` also register the package repo so later versions arrive through `apt upgrade` or `dnf upgrade`. Every artifact ships a SHA-256 sidecar and a Minisign signature.
- [Install docs →](https://paneflow.dev/docs/installation)
- <img alt="Claude Code working in a pane, the dock open on a Rust file beside the file tree, and the Workspaces rail listing projects, their worktree tabs, and agent sessions" src="./assets/images/demo-0.19.png" width="100%">
- ### 2. Install for agents
- Let one agent read another agent's pane, so you stop copy-pasting scrollback between them.
- ```bash
- paneflow mcp install
- ```
- This registers a local MCP bridge for supported agents it detects: Claude Code, Codex, Gemini CLI, and OpenCode. Its read tools are `list_panes`, `read_pane`, and `search_pane`, and terminal output comes back wrapped as untrusted data for the reading agent to analyze. Its one write tool, `write_pane`, sends a message to another agent's pane only after you allow that pair of agent sessions in Paneflow.
- [Bridge docs →](docs/user/scripting.md)
- ### 3. Coordinate a fleet
- The `paneflow` CLI lets a script or an agent read, monitor, and control the panes you are watching. For text injection, launch Paneflow with `PANEFLOW_IPC_SCRIPTING=1`; `send` pre-fills text unless you explicitly add `--submit`.
- ```bash
- paneflow ps
- paneflow read cargo-run --lines 100
- paneflow send codex-review "Review this branch and report risks"
- paneflow wait --match claude-impl --pattern "REPORT_DONE"
- paneflow watch --type ai.stop
- ```
- `paneflow up` spawns a declarative workspace. `paneflow flow run` executes the steps you define in `flow.toml`: spawn panes or send text, order steps through dependencies, wait for readiness patterns, and capture output. Launching panes with commands or prompts requires `PANEFLOW_IPC_ORCHESTRATION=1` or `PANEFLOW_IPC_SCRIPTING=1`. Prompt submission remains explicit and permission-gated.
- [Conductor docs →](docs/user/conductor.md)
- ### 4. Configure
- Themes, shell, keybindings, and shortcuts live in `~/.paneflow/paneflow.json` (`%USERPROFILE%\.paneflow` on Windows) and hot-reload while the app runs. Everything is also editable in Settings.
- [Learn more →](docs/user/configuration.md)
- ## Keep sessions running
- Terminal sessions live in a separate host process. Choose **Keep sessions running** when quitting Paneflow to leave the terminals and their processes alive, then reopen the app to reconnect. Choose **Stop everything and quit** to end them.
- This keeps live sessions across app closure while the host and machine remain running. Restarting an ended terminal starts a fresh shell; resuming an agent conversation uses that agent's own session support. Neither operation restores a process after a machine restart or host crash.
- ## Read what the agents changed
- The Changes tab compares the active checkout with `HEAD`, including staged and unstaged changes and untracked files. Read split or unified diffs, highlight changes within lines, and revert individual blocks in modified files. Whitespace can be trimmed or ignored.
- Open files in the integrated editor to make changes, save, undo, or redo. Git markers in the gutter open a popup to read, copy, or revert the previous text. Paneflow also detects changes made on disk while you edit and lets you resolve save conflicts.
- ## Telemetry
- Telemetry is opt-in, never includes terminal contents, paths, or prompts, and `PANEFLOW_NO_TELEMETRY=1` disables it regardless of config.
- ## Build from source
- Paneflow pins Rust 1.98.0 through [rust-toolchain.toml](rust-toolchain.toml). Linux builds need Vulkan and the usual Wayland/X11 development libraries.
- ```bash
- git clone https://github.com/arthjean/paneflow.git
- cd paneflow
- scripts/fetch-libghostty.sh # terminal engine archives, verified against native/libghostty/manifest.toml
- cargo run --release -p paneflow-app
- ```
- On Windows, also run `scripts/fetch-conpty.ps1` in PowerShell 7 before building,
- or use `scripts/dev.ps1 -Release`, which fetches the pinned ConPTY runtime and
- builds both the app and its session host.
- [ARCHITECTURE.md](ARCHITECTURE.md) covers the runtime and thread model, [AGENTS.md](AGENTS.md) the repository instructions for coding agents.
- ## Contributing
- [Issues welcome!](https://github.com/arthjean/paneflow/issues)
- ## License
- [GPL-3.0-or-later](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.