Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/arthjean--paneflow/badge.svg)](/listings/arthjean--paneflow)

HTML

<a href="/listings/arthjean--paneflow"><img src="/api/listings/arthjean--paneflow/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

  1. <img alt="Paneflow" src="./src-app/assets/icons/paneflow.png" width="36" height="36">
  2. [![version](https://img.shields.io/github/v/release/arthjean/paneflow?sort=semver&style=flat&label=version&colorA=000000&colorB=000000)](https://github.com/arthjean/paneflow/releases/latest)
  3. [![license](https://img.shields.io/github/license/arthjean/paneflow?style=flat&label=license&colorA=000000&colorB=000000)](LICENSE)
  4. [![platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-000000?style=flat&colorA=000000&colorB=000000)](#install)
  5. [![discord](https://img.shields.io/badge/discord-join-000000?style=flat&colorA=000000&colorB=000000)](https://discord.gg/UqGM29Gvat)
  6. The multiplexer for the agent era.
  7. 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.
  8. 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.
  9. Works with any CLI agent - Claude Code, Codex, Gemini, opencode, Pi, Hermes, you name it.
  10. 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.
  11. 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.
  12. [Website →](https://paneflow.dev)
  13. ## Install
  14. ### 1. Quick start
  15. On macOS:
  16. ```bash
  17. brew install --cask arthjean/paneflow/paneflow
  18. ```
  19. 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.
  20. [Install docs →](https://paneflow.dev/docs/installation)
  21. <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%">
  22. ### 2. Install for agents
  23. Let one agent read another agent's pane, so you stop copy-pasting scrollback between them.
  24. ```bash
  25. paneflow mcp install
  26. ```
  27. 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.
  28. [Bridge docs →](docs/user/scripting.md)
  29. ### 3. Coordinate a fleet
  30. 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`.
  31. ```bash
  32. paneflow ps
  33. paneflow read cargo-run --lines 100
  34. paneflow send codex-review "Review this branch and report risks"
  35. paneflow wait --match claude-impl --pattern "REPORT_DONE"
  36. paneflow watch --type ai.stop
  37. ```
  38. `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.
  39. [Conductor docs →](docs/user/conductor.md)
  40. ### 4. Configure
  41. 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.
  42. [Learn more →](docs/user/configuration.md)
  43. ## Keep sessions running
  44. 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.
  45. 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.
  46. ## Read what the agents changed
  47. 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.
  48. 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.
  49. ## Telemetry
  50. Telemetry is opt-in, never includes terminal contents, paths, or prompts, and `PANEFLOW_NO_TELEMETRY=1` disables it regardless of config.
  51. ## Build from source
  52. Paneflow pins Rust 1.98.0 through [rust-toolchain.toml](rust-toolchain.toml). Linux builds need Vulkan and the usual Wayland/X11 development libraries.
  53. ```bash
  54. git clone https://github.com/arthjean/paneflow.git
  55. cd paneflow
  56. scripts/fetch-libghostty.sh # terminal engine archives, verified against native/libghostty/manifest.toml
  57. cargo run --release -p paneflow-app
  58. ```
  59. On Windows, also run `scripts/fetch-conpty.ps1` in PowerShell 7 before building,
  60. or use `scripts/dev.ps1 -Release`, which fetches the pinned ConPTY runtime and
  61. builds both the app and its session host.
  62. [ARCHITECTURE.md](ARCHITECTURE.md) covers the runtime and thread model, [AGENTS.md](AGENTS.md) the repository instructions for coding agents.
  63. ## Contributing
  64. [Issues welcome!](https://github.com/arthjean/paneflow/issues)
  65. ## License
  66. [GPL-3.0-or-later](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.