Parallel Code
把 Claude Code、Codex、Gemini 等 AI 编码代理并行派发到各自独立的 git worktree 中,一次下午跑十个分支,审完差异只留下最好的。
加2分项:worktree隔离、项目级Dockerfile沙箱、semgrep安全规则与gitleaks密钥扫描、CI动作按commit SHA固定;扣分:合并/推送到远端的用户确认机制未见文档、'Share agent auth'与直连模式削弱隔离、代码问答发送到外部LLM(MiniMax)的数据流向披露薄弱、无明确回滚/撤销设计,作者身份仅凭package.,无签名或 provenance。
README、package.与CI描述基本自洽且测试脚本分层清晰(单元/客户端/pty集成);扣分:依赖多个beta版xterm包和外部CLI(Claude Code/Codex等)的版本无约束,错误消息质量未在证据中体现。
明确面向macOS/Linux的开发者,覆盖多个CLI工具、Docker隔离与无git目录场景,Antigravity的Docker认证局限被明确说明(边界披露良好);扣分:功能触发条件与Windows支持缺席,仅README层面无法验证运行时适配。
安装说明(release/源码构建)、快捷键表、对比表、截图与MIT许可(README与LICENSE一致,得满分);扣分:无CHANGELOG文件、已知局限仅散落在折叠段落、维护者承诺与更新路径无文档,版本号1.15.0存在但发布流程仅npm version patch。
核心价值清晰(多agent并行+worktree隔离+diff评审),键盘优先与手机监控有差异化;扣分:实际成本(token消耗、多agent并发费用)未讨论,效果主张均为未执行的静态断言。
CI含coverage下限、semgrep规则自测试、pty集成测试,主张可部分追溯至脚本;扣分:证据仅四个文件,无法交叉验证screens/演示与代码行为,README营销语句与事实性陈述未明确区分。
- 静态审查,未执行任何运行验证;安装前请自行审查主进程与MCP服务器代码。
- 合并到main、推送到远端、直连模式均绕过隔离,操作前确认目标分支。
- 代码问答与手机远程监控涉及代码/数据离开本机(MiniMax、Wi-Fi/Tailscale),敏感仓库慎用。
- Antigravity在Docker隔离下无法认证,仅可原生运行;'共享agent认证'会扩大凭据暴露面。
- 部分终端依赖为beta版本,且运行依赖外部CLI的可用性与版本。
这个 Agent 能做什么,适合哪些场景?
Parallel Code(GitHub: johannesjo/parallel-code)是一款基于 Electron 和 SolidJS、用 TypeScript 编写的桌面应用,运行于 macOS 和 Linux。它的核心做法是:为每个任务从主分支新建 git 分支并创建 git worktree,把 node_modules 等被 gitignore 的目录符号链接进去,然后在该 worktree 中启动所选的 AI 编码 CLI。它通过一个界面统一管理 Claude Code、Codex CLI、Gemini CLI、Antigravity CLI 和 Copilot CLI,支持多任务并行、内联评论的差异审查、AI Arena 竞速对比、手机扫码远程监控等能力。任务完成后可从侧边栏一键把分支合并回主分支。它 MIT 授权、免费开源,不依赖任何额外平台订阅,但本身不包含模型,必须安装至少一个 AI 编码 CLI 才能工作。
创建任务时,Parallel Code 依次执行:1) 从主分支创建新的 git 分支;2) 用 git worktree 为代理建立独立工作目录;3) 将 node_modules 等被 gitignore 的目录符号链接进 worktree;4) 在该 worktree 中启动 AI 代理。可选地,若项目根目录有 .parallel-code/Dockerfile,任务会在 Docker 沙箱中运行。结果方面:内置差异查看器支持内联审查评论和逐 commit 导航;Steps 面板以时间线展示代理进度(写入 .claude/steps.);每个任务有笔记面板和独立 shell 终端;监控 GitHub PR CI 状态并推送桌面通知;合并通过侧边栏的 Merge 操作(快捷键 Ctrl+Shift+M)完成。代码问答默认走 Claude Code,也可配置为 MiniMax M2.7(204K 上下文)。
- 同时开发多个功能的独立开发者:把五个任务分给五个代理并行跑,各自隔离在独立分支,互不冲突。
- 想对比不同模型/CLI 的工程师:用 AI Arena 模式让 Claude Code 和 Codex 竞速同一任务,挑 diff 更好的那个合并。
- 习惯 tmux 但厌倦手工管理 worktree 的终端用户:获得自动分支/worktree 隔离、合并按钮和 GUI 差异审查。
- 需要离开工位的人:扫描二维码,通过 Wi-Fi 或 Tailscale 用手机查看代理进度。
- 对代码安全敏感的团队:用项目级 .parallel-code/Dockerfile 把任务隔离在沙箱中运行。
- 键盘优先的重度用户:每个操作都有快捷键(Ctrl+N 新建任务、Ctrl+Enter 发送提示等),鼠标可选。
这个 Agent 有哪些优点和局限?
- 真正的并行隔离:每个任务自动获得独立 git 分支和 worktree,无需手工管理,多个代理同时工作零冲突。
- 多 CLI 统一入口:Claude Code、Codex CLI、Gemini CLI、Copilot CLI(及 Antigravity CLI)在同一界面调度切换,不被单一供应商锁定。
- 键盘优先且可远程监控:全部操作有快捷键,还能扫码用手机(Wi-Fi/Tailscale)查看进度。
- 可审计的审查流程:内置差异查看器支持内联评论、逐 commit 导航和 AI Arena 对比模式。
- 可选 Docker 沙箱:通过项目级 .parallel-code/Dockerfile 隔离代理执行环境。
- 仅支持 macOS 和 Linux,没有 Windows 版本。
- 依赖外部付费/订阅的 AI CLI 本体——应用免费但必须自行安装并认证 Claude Code、Codex CLI 等,模型费用另计。
- Docker 沙箱中的 Antigravity 任务无法认证(依赖系统钥匙串),必须原生运行,属于已记录的功能限制。
- 直接模式在无隔离的主分支上工作时失去 worktree 保护;对非 git 文件夹的支持存在但隔离能力不同。
- 源码构建需要 Node.js v18+ 和 npm 环境,桌面 Electron 应用本身也有一定资源占用。
如何安装或部署这个 Agent?
方式一:从 GitHub Releases 页面(github.com/johannesjo/parallel-code/releases/latest)下载对应平台安装包——macOS 为 .dmg(universal),Linux 为 .AppImage 或 .deb。方式二:从源码构建:
git clone https://github.com/johannesjo/parallel-code.git
cd parallel-code
npm install
npm run dev前提条件:Node.js v18+。另外必须安装至少一个 AI 编码 CLI:Claude Code、Codex CLI、Gemini CLI、Antigravity CLI 或 Copilot CLI,并完成各自的登录/认证。
如何使用这个 Agent?
1) 打开 Parallel Code,指向一个 git 仓库;2) 新建任务(Ctrl+N),选择要使用的代理;应用会自动建分支、建 worktree 并在其中启动代理;3) 通过差异查看器审查变更、添加内联评论,或在任务笔记面板写好提示发给代理;4) 满意后按 Ctrl+Shift+M 将任务合并回主分支,或 Ctrl+Shift+P 推送到远端;5) 可按 Ctrl+Shift+F 进入单任务专注模式,按 Ctrl+/ 查看全部快捷键。若要 Docker 沙箱隔离,在项目根目录放置 .parallel-code/Dockerfile;注意 Antigravity CLI 因使用系统钥匙串认证,需以原生(非 Docker)方式运行。
这个 Agent 与同类方案有什么区别?
README 自述对比:多个终端窗口/tmux 方案缺乏 GUI 和自动 git 隔离,worktree、分支、合并需手工处理;VS Code 扩展(如 Kilo Code、Roo Code)绑定 VS Code,代理之间没有真正的并行 worktree 隔离;顺序运行代理则一次只能一个任务,阻塞工作流。Parallel Code 针对这些缺口提供 GUI、自动隔离与真正并行。