Paneflow 是一个原生、GPU 加速的工作区，用于并行运行 CLI 编码智能体。 它不是托管式智能体 runtime，也不是通用终端功能清单。它围绕你已经在 运行的工具，提供可见窗格、项目上下文、智能体状态、本地编排和 review 界面。
第一次使用 Paneflow？先阅读 开始使用，再把本页当成功能地图。
功能地图
- 工作区： 窗格、布局、项目、标签页和会话恢复。阅读 布局。
- 智能体： 智能体窗格、项目 thread、自由 chat 和生命周期状态。阅读 Conductor。
- 上下文： 文件树、分支徽标、dev server 端口和可点击 URL。阅读 快捷键和操作。
- 编排： CLI、JSON-RPC IPC、
paneflow up、paneflow flow和事件流。阅读 Scripting。 - MCP： 为已配置智能体提供只读窗格访问。阅读 Scripting。
- Review： Git worktree、diff 列、review prompt 和人工批准的 handoff。阅读 Review。
- 设置： 主题、终端默认值、workspace template 和 AI access controls。阅读 Settings。
工作区模型
Paneflow 有两个核心层：工作区 和 窗格。工作区是独立的项目上下文。 窗格是该工作区内真正的终端分屏。
将焦点窗格水平分屏（Cmd/Ctrl+Shift+D）或垂直分屏
（Cmd/Ctrl+Shift+E）。每个新窗格都会在同一工作目录中启动 shell。
使用 Alt+Arrow 移动焦点，使用 Cmd/Ctrl+Shift+N 打开另一个工作区，
并通过四个 布局预设 重塑当前窗格树：均匀水平、均匀垂直、
主竖直和平铺。
会话恢复会保存工作区布局、窗格树、工作目录、自定义按钮、项目和 chat。scrollback 仅保留在当前进程中，因此重新启动 Paneflow 后，终端输出会从空白状态开始。它不会在 app 关闭后保持子进程存活，因此当底层进程已经退出时，需要重新启动长时间运行的 dev server 或智能体。
智能体监督
启动 Claude Code、Codex、OpenCode、Gemini、Pi、Hermes，或任何在 PATH 中
可用的 CLI 智能体。Paneflow 会在普通 PTY 窗格中运行该智能体，因此你可以查看原始
终端、中断它，或用键盘接管。
受支持并接入 hook 的智能体可以报告更丰富的生命周期状态，例如 thinking、waiting、 finished、errored 或 stalled。其他 CLI 工具仍然可以在窗格中运行，但 Paneflow 只能 从进程树和终端活动中推断状态。
在项目中，使用项目 thread 来运行限定在 codebase 内的独立智能体会话。对于研究、
计划或不属于某个项目的快速问题，可以从 home 目录（~）打开智能体 chat。过去的
chat 会保留在侧边栏中。
工作区上下文
将 Paneflow 指向一个 codebase，它就会成为一个项目：文件树会在侧边栏中打开，active Git branch 会显示在 header 中，新窗格会限定在该目录内。当你需要在多个 repository 之间切换，同时保留每个窗格的本地上下文时，可以在同一个窗口中以标签页打开多个项目。
文件树让你浏览当前工作区，在智能体会话旁边打开文件，并复制绝对路径或相对路径用于 prompt 和 command。自定义 action button 可以把常用 command 固定在窗口顶部，例如 build、test、lint 或 dev server 启动命令。
当窗格内的进程绑定 listening port 时，Paneflow 会根据 Linux、macOS 和 Windows 上的 OS 进程表和 socket 表，将该端口归属到对应窗格。Next.js、Vite、Nuxt、Remix、Astro、 Webpack、Angular 和 React scripts 等已知 frontend tool 可以显示可点击 URL。当输出 包含足够信号时，terminal banner matching 会为更多 server type 添加 label。
Scripting 和 MCP
paneflow binary 也是基于 Paneflow JSON-RPC IPC socket 的本地 CLI。script 可以列出
窗格、读取 scrollback、搜索输出、检查智能体状态、stream 生命周期事件、分割窗格、
聚焦窗格、在 write gate 后预填 prompt、用 paneflow up 启动 declarative workspace，
并用 paneflow flow 运行 multi-agent DAG。
Paneflow 还提供只读 MCP 桥接。为受支持智能体安装后，它会暴露 list_panes、
read_pane 和 search_pane，让 assistant 无需复制粘贴即可检查另一个窗格。该桥接
不能向窗格输入或控制窗格，终端输出也会作为不可信数据返回。
完整命令参考在 Scripting and automation 中。
Worktrees 和 review
创建 Git worktree 来处理独立任务，而不触碰主 checkout。Paneflow 会将每个 worktree 作为独立上下文打开，拥有自己的 branch、files、panes 和 agent sessions。这样，并行 智能体工作保持可见，不会把每个任务都压进同一个 working tree。
review 界面会并排显示 worktree diff，并提供 hunk navigation、review prompt 和嵌入式 review terminal。Paneflow 可以为智能体预填 prompt，但正常 flow 仍然由人批准：发送 什么、何时提交，都由你决定。
阅读 Review 获取完整 workflow。