Paneflow 是一个原生、GPU 加速的工作区，用于并行运行 CLI 编码智能体。 它不是托管式智能体 runtime，也不是通用终端功能清单。它围绕你已经在 运行的工具，提供可见窗格、项目上下文、智能体状态、本地编排和 review 界面。
第一次使用 Paneflow？先阅读 开始使用，再把本页当成功能地图。
功能地图
- 工作区： 窗格、布局、项目、标签页和会话恢复。阅读 布局。
- 智能体： 智能体窗格、项目 thread、自由 chat 和生命周期状态。阅读 Conductor。
- 上下文： 文件树、分支徽标、dev server 端口和可点击 URL。阅读 快捷键和操作。
- 编排： CLI、JSON-RPC IPC、
paneflow up、paneflow flow和事件流。阅读 Scripting。 - MCP： 为已配置智能体提供只读窗格访问。阅读 Scripting。
- Changes 和 Files： 每个会话旁的 dock，显示 checkout 相对 base branch 的 diff，并用代码编辑器打开项目中的任意文件。
- 设置： 主题、终端默认值、workspace template 和 AI access controls。阅读 Settings。
工作区模型
Paneflow 有两个核心层：工作区 和 窗格。工作区是独立的项目上下文。 窗格是该工作区内真正的终端分屏。
将焦点窗格水平分屏（Cmd/Ctrl+Shift+D）或垂直分屏
（Cmd/Ctrl+Shift+E）。每个新窗格都会在同一工作目录中启动 shell。
使用 Alt+Arrow 移动焦点，使用 Cmd/Ctrl+Shift+N 打开另一个工作区，
并通过四个 布局预设 重塑当前窗格树：均匀水平、均匀垂直、
主竖直和平铺。
会话恢复会保存工作区布局、窗格树、工作目录、自定义按钮、项目和 chat。终端运行在 一个比窗口更长寿的本地宿主进程中：退出 Paneflow 只会分离视图，shell 和智能体继续 运行，重新打开 app 时每个窗格都会重新连接到同一个会话并恢复其屏幕。关闭窗格、 标签页或工作区会停止其中的会话，菜单标签也会如此说明。要在保留进程的同时把窗格 从布局中移除，请使用窗格菜单中的 从布局中隐藏；隐藏的会话仍列在侧边栏的工作区 下方，一键即可重新打开。
智能体监督
启动 Claude Code、Codex、OpenCode、Gemini、Pi、Hermes，或任何在 PATH 中
可用的 CLI 智能体。Paneflow 会在普通 PTY 窗格中运行该智能体，因此你可以查看原始
终端、中断它，或用键盘接管。
受支持并接入 hook 的智能体可以报告更丰富的生命周期状态，例如 thinking、waiting、 finished、或 errored。其他 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
创建 Git worktree 来处理独立任务，而不触碰主 checkout。Paneflow 会将每个 worktree 作为独立上下文打开，拥有自己的 branch、files、panes 和 agent sessions。这样，并行 智能体工作保持可见，不会把每个任务都压进同一个 working tree。
阅读 Worktree 了解 worktree 如何创建、存放、清理和恢复。