【免费下载链接】pi-guiElectron GUI app for the pi coding agent runtime项目地址https://gitcode.com/gh_mirrors/pi/pi-gui点击查看免费下载pi-gui 是一款基于 pi coding agent 的 Electron 桌面 GUI 应用让你并行跑多个 AI Agent任务每个任务一个独立 thread可选在本地代码目录Local或独立的 git worktreeWorktree中执行互不干扰。本文是一份面向新手的实战指南带你从安装到并行调度完整掌握 Local 与 Worktree 双模式的使用技巧。为什么需要并行跑多个 Agent一个人写提示词、等 Agent 跑完再写下一个——效率瓶颈往往在等待上。pi-gui 的做法是每个任务一个 thread可以同时发起多个任务第一个还在跑就继续发起第二个侧边栏实时状态正在运行running、已完成但未查看unseen、失败failed一目了然隔离执行环境Local 模式快速直接Worktree 模式让每个 Agent 拥有独立工作目录改动互不污染。准备工作安装 pi-gui 并添加 workspacepi-gui 支持 macOSApple Silicon、Linuxx64和 Windowsx64。从 Releases 页面下载.dmg/.AppImage/.exe安装包打开Settings → Providers连接模型提供方OAuth 或 API key添加一个 workspace你的本地项目文件夹。 pi-gui 直接读写 pi 自身的会话文件与配置线程、凭据、skills 与 pi CLI 完全共享。详细说明见 README.md。如果习惯从源码运行需要 Node 22.19 与 pnpmcorepack enable pnpm install pnpm devLocal 模式在现有代码目录直接运行新建 thread 时输入框下方有一个Local / Worktree切换按钮见 new-thread-view.tsx默认是 LocalAgent 直接在你当前打开的代码目录里读写文件、跑测试启动零等待适合随手改个小 bug、解释这段代码这类轻任务多个 Local thread 可以并行但它们操作同一个工作目录改动会互相叠加。适合场景同一项目的连续小任务、只读分析、文档类工作。Worktree 模式给每个 Agent 一个独立 git 工作区把模式切到Worktree再发送提示词pi-gui 会先自动创建一个 git worktree然后才把任务交给 Agent底层执行的是git worktree add -b pi/name path HEAD工作目录统一放在应用专属的 worktree 根目录下实现见 worktree-manager.ts每个 thread 的 worktree 都使用pi/前缀的分支天然与你的功能分支区分开事务性保证如果 thread 创建过程中出错刚创建的 worktree 和分支会被自动回滚删除不留垃圾见 app-store-worktree.ts启动应用时已合并进 HEAD 的孤儿 worktree 会被自动清理有未提交改动的工作区永远不会被强制删除保护你的劳动成果。实战三步一次拉起多个 Agent以并行修两个独立 bug为例步骤操作说明1️⃣New thread → 选 Local → 发送提示词 A第一个 Agent 立即开始工作2️⃣再点 New thread → 选 Worktree → 发送提示词 B自动建 worktree第二个 Agent 在独立目录开跑3️⃣Ctrl TabmacOS 同为Ctrl Tab在两个 thread 间切换侧边栏实时显示两者的运行状态几个实用的并行技巧Ctrl Tab在最近 thread 间快速切换⌘/Ctrl K打开命令面板按名称搜索、跳转到任意 threadpalette 面板源码⌘/Ctrl 1~9直接跳到侧边栏对应位置的 thread运行中按Enter可以排队追加后续指令⌘/Ctrl Enter可以中途纠偏当前 run每个 thread 可单独选择模型和 thinking level重活用大模型、轻活用小模型自由组合。后台运行与完成通知你不必盯着屏幕后台 thread 结束时侧边栏该行会点亮unseen指示点失败则显示 failed 状态状态指示实现见 sidebar.tsx系统通知会在后台 thread完成、失败或需要你介入时提醒你切换 thread 不会打断正在运行的会话——多个 run 真正并行官方 E2E 测试 parallel-runs.spec.ts 就专门验证了两个会话同时 running、状态互不串染。收尾流程Review 审查 Terminal 验证Agent 干完活之后两个面板帮你把关ChangesReview标签页——逐文件审查 Agent 的改动支持对比未提交工作区、分支对基线、单个 turn 的 diff可以按文件 stage/unstageTerminal 标签页——每个任务自带真实终端Agent 自己跑npm test你也可以随时手动复验快捷键 ⌘/Ctrl JWorktree 任务验证通过后合并对应pi/分支即可worktree 不再需要时可从 workspace 菜单移除pi-gui 只会删除它自己创建pi/分支的 worktree你的其他 checkout 不受影响。进阶从任意消息 Fork 出分叉任务对某个回答不满意在消息上触发Fork conversationfork-modal.tsx把对话复制到一个全新 thread 继续原 thread 原封不动Same worktree分叉到同一工作区换方向继续New worktree分叉到全新 worktree两个方案并排赛马最后选胜者合并。配合/tree命令还能在会话树上自由穿梭找回任何历史分支点。常见问题 FAQQ1Local 和 Worktree 到底怎么选轻量、只读或快速迭代选 Local会改文件、需要独立分支、或想并行对比多种实现选 Worktree。Q2Worktree 模式会污染我的主分支吗不会。新 worktree 基于HEAD检出到独立的pi/分支主工作区的文件、分支、索引全程不动。Q3worktree 越积越多怎么办启动时自动清理已合并的孤儿 worktreeworktree-manager.ts 中的pruneOrphanedWorktrees未合并的会保留并报告绝不会误删有改动的目录。Q4非 git 项目能用吗Worktree 模式依赖 git 仓库非 git 目录请全程使用 Local 模式。总结pi-gui 的并行能力可以浓缩为一句话Local 图快Worktree 图稳。Local 模式零等待适合连续轻任务Worktree 模式自动创建独立 git 工作区 pi/分支事务回滚 自动清理安全省心侧边栏状态指示、后台通知、CtrlTab 快速切换让放线—收割式的多 Agent 工作流顺畅运转用 Fork 从任意消息分叉让两个方案并行赛马。更多架构细节主进程 / preload / renderer 边界、会话所有权可阅读 docs/architecture.md。现在就可以打开 pi-gui发起你的第一个并行任务。赞分享【免费下载链接】pi-guiElectron GUI app for the pi coding agent runtime项目地址https://gitcode.com/gh_mirrors/pi/pi-gui点击查看免费下载相关推荐Zed Parallel Agents 实战指南用 Threads Sidebar 并行驱动多个 AI 代理线程与 Git Worktree 隔离Zed Parallel Agents 实战指南用 Threads Sidebar 并行驱动多个 AI 代理线程与 Git Worktree 隔离 本文介绍开发工具代码编辑器桌面应用GSD-2 并行 Milestone 编排多 Worktree 隔离并行执行的架构与实战指南GSD 2 并行 Milestone 编排多 Worktree 隔离并行执行的架构与实战指南 导读 GSD 2gsd 2是一个以 meta prompti人工智能AI Agent代码智能体Agent 编排CLIAI 应用在 Saleor 仓库中使用 Worktree-safe Dev Container 并行运行多个 Git Worktree在 Saleor 仓库中使用 Worktree safe Dev Container 并行运行多个 Git Worktree 导读 Saleor 是一个高性能、后端电商创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考