Paneflow：编码 Agent 终端多路复用器

项目简介

Paneflow 是一款面向编码 Agent 的原生终端多路复用器（terminal multiplexer）。它用 Rust 和 Zed 的 GPUI 构建，终端引擎来自 Ghostty 的 libghostty-vt。你可以并行运行多个 CLI Agent，把项目组织成标签页与分屏，然后在原生界面里查看它们到底改了什么。它兼容各类 CLI Agent，例如 Claude Code、Codex、Gemini、opencode、Pi、Hermes。

Paneflow 完全在本地运行：Agent 就是普通终端里的普通 CLI 进程，各自连接自己的模型服务商。提示词由 Paneflow 预填，需要你按 Enter 发送，自动提交是显式且有权限限制的。活动追踪能力取决于各 Agent 提供的集成。

主要功能

• 并行与分屏：按标签页和窗格组织项目，必要时在一个标签页里同时放多个 Agent。
• 持久会话：终端会话运行在独立的 host 进程里。退出时选择 Keep sessions running，终端及其进程会继续存活，重新打开应用即可重连。
• 任务隔离：可以直接在已有 checkout 中工作，也可以为独立任务创建分支和 Git worktree。
• Changes：对比当前 checkout 与 HEAD 的差异，包含已暂存、未暂存改动和未跟踪文件；支持分离或统一 diff、行内高亮、按块回退，以及裁剪或忽略空白。
• Files：集成编辑器带 Git 标记和文件树，支持修改、保存、撤销、重做；点击边栏标记可查看、复制或回退旧文本，并能检测编辑期间磁盘上的改动并处理保存冲突。
• Dock：把 Changes、Files 和终端集中在一处。
• 活动追踪：跟进 Agent 活动，看出哪些会话需要关注，并读取、打断或接管任意终端。
• MCP 桥接：paneflow mcp install 会为检测到的 Claude Code、Codex、Gemini CLI、OpenCode 注册本地 MCP 桥，提供 list_panes、read_pane、search_pane 读取工具，以及需要在你授权会话对之后才能使用的 write_pane 写入工具。
• CLI 协同：paneflow ps、read、send、wait、watch 可读取、监控和控制窗格；paneflow up 启动声明式工作区，paneflow flow run 执行 flow.toml 里定义的步骤，支持依赖排序、等待就绪模式与输出捕获。

安装与使用

macOS 可以用 Homebrew 安装：

brew install --cask arthjean/paneflow/paneflow

其他平台从最新 release 下载对应构建：Linux 提供 .AppImage、.deb、.rpm，Windows 用 .msi 安装。.deb 与 .rpm 还会注册软件源，后续版本可通过 apt upgrade 或 dnf upgrade 升级。每个产物都附带 SHA-256 校验文件和 Minisign 签名。

主题、shell、键位和快捷键写在 ~/.paneflow/paneflow.json（Windows 为 %USERPROFILE%\.paneflow），应用运行时会热重载，也可以在 Settings 中修改。

从源码构建（Rust 通过 rust-toolchain.toml 固定为 1.98.0，Linux 需要 Vulkan 以及常见的 Wayland/X11 开发库）：

git clone https://github.com/arthjean/paneflow.git
cd paneflow
scripts/fetch-libghostty.sh
cargo run --release -p paneflow-app

在 Windows 上构建前还需在 PowerShell 7 里运行 scripts/fetch-conpty.ps1，或直接用 scripts/dev.ps1 -Release。

注意事项

• 持久会话的前提是 host 进程和机器仍在运行。机器重启或 host 崩溃后都无法恢复进程：重启已结束的终端会得到一个新 shell，恢复 Agent 对话则依赖该 Agent 自身的会话支持。
• 文本注入需以 PANEFLOW_IPC_SCRIPTING=1 启动 Paneflow；用命令或提示词启动窗格需 PANEFLOW_IPC_ORCHESTRATION=1 或 PANEFLOW_IPC_SCRIPTING=1。send 默认只预填文本，需显式加 --submit 才提交。
• 遥测默认关闭，需主动开启，且不包含终端内容、路径或提示词；PANEFLOW_NO_TELEMETRY=1 可无视配置直接关闭。
• 许可证为 GPL-3.0-or-later。

---

本作品整理自 GitHub 开源项目 arthjean/paneflow，原作者 @arthjean，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。