workmux 并行开发实战从 add 到 merge 的完整工作流清单【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmuxworkmux 是一款把git worktrees tmux 窗口捆绑管理的开源并行开发工具一条workmux add命令即可创建独立开发环境一条workmux merge命令即可完成合并与全量清理。本文带你走通从创建 worktree 到合并收尾的完整实战流程零冲突、零切换分支特别适合多 AI Agent 并行写代码的场景 为什么需要 workmux 并行开发传统 Git 流程下切换任务意味着git stash、切分支、重跑环境。而 git worktrees 允许同一仓库的多个分支同时检出于不同目录。workmux 在此之上做了三件关键的事一个任务一个窗口每个 worktree 自动配一个同名 tmux 窗口含独立终端状态、编辑器、开发服务器和 AI Agent环境自动就绪新 worktree 自动拷贝.env、软链node_modules、跑post_create钩子不再新建即损坏一条命令收尾workmux merge完成合并、删 worktree、关窗口、删分支的全生命周期清理。 workmux 默认使用 tmux也支持 kitty、WezTerm、Zellij 作为终端复用后端。快速安装与环境准备brew install raine/workmux/workmux # HomebrewmacOS/Linux # 或 cargo install workmux # Cargo然后在项目里跑一次workmux init可选生成.workmux.yaml配置文件自定义窗格布局、初始化钩子与文件操作。不配置也能开箱即用workmux 内置了合理默认值。第一步用 workmux add 创建并行工作区在 tmux 窗口内执行workmux add user-auth一条命令背后自动完成 7 件事完整逻辑见 add 命令实现基于分支名生成 handle如feature/auth→feature-auth在项目__worktrees/user-auth目录创建 git worktree执行文件拷贝/软链操作如.env、node_modules运行post_create钩子装依赖、建数据库等创建 tmux 窗口wm-user-auth按配置铺好窗格布局编辑器 Agent 开发服务器自动把光标切到新窗口几个实战高频参数场景命令交给 AI Agent 干workmux add feat -p 实现用户登录后台创建不打断当前工作workmux add feat -b把当前未提交改动搬过去workmux add feat --with-changes一次给多个 Agent 各建一个workmux add feat -a claude -a gemini从 PR 检出一个工作区workmux add --pr 123预览将做什么不创建workmux add feat --dry-run创建多个独立工作区时只需重复add各窗口互不干扰——这就是并行的全部秘密。第二步并行开发期间如何掌控全局多个窗口同时跑着 Agent靠什么盯进度workmux 提供三层监控手段①workmux list一览状态workmux list输出包含每个 worktree 的分支、Agent 状态 工作中 / 等待输入 / ✅ 完成、窗口是否存在、是否有未合并提交。加--pr还能显示 PR 检查状态。② Dashboard 看板审查改动、直接给 Agent 发消息workmux dashboardDashboard 支持按d查看 WIP 差异、按i进入输入模式直接回复 Agent 提问、按R一键批量清理已合并/已删除的工作区是并行开发中的指挥中心。③ Sidebar 侧边栏常驻的轻量状态条workmux sidebar在 tmux 中常驻显示所有 worktree 的 Agent 状态、git 差异统计和 PR 信息不打断当前工作流适合常驻开启。进阶让主 Agent 替你分发任务安装官方技能workmux setup --skills后可以在对话中用/worktree技能把任务委托给新 worktree 中的 Agent它会自动写好 prompt 文件并执行workmux add参见 worktree 技能定义 /worktree 实现我们讨论过的缓存层多任务需要按顺序合并、全程自动监控时用/coordinator技能让主 Agent 负责派发、等待、审查和合并的全生命周期你完全不用手动盯。第三步workmux merge 一键合并并全量清理开发完成后在对应 worktree 窗口内直接执行workmux merge不带参数时自动识别当前分支随后自动完成 8 步收尾检查未提交改动 → 提交已暂存内容 → 合并到 main → 关 tmux 窗口 → 删 worktree 目录 → 删本地分支。常用变体workmux merge user-auth # 合并指定分支 workmux merge user-auth --rebase # 先 rebase 保持线性历史 workmux merge user-auth --squash # 压缩为单个提交 workmux merge user-auth --keep # 先合并、暂不清理验证后再 workmux remove workmux merge subtask --into parent # 合并进父分支stacked 工作流不想手动操作给 Agent 装上 /merge 技能输入/merge即可自动提交带上下文感知的 commit message→ rebase 到基分支 → 智能解决冲突 → 执行workmux merge。相关命令实现可参考 merge 模块 与 workflow 合并逻辑。替代路线PR 工作流收尾如果团队走 Pull Request 评审合并发生在远端。流程是push 分支、创建 PR可用/open-pr技能 让 Agent 基于对话上下文写好描述PR 合并后本地清理workmux remove feature-123 # 清理指定 worktree workmux rm --gone # 一键清理所有远端分支已删除的 worktree--gone特别实用PR 合并后远端分支自动删除这条命令会批量找出并移除这些孤儿工作区。完整工作流清单可收藏版阶段命令说明初始化workmux init生成项目配置.workmux.yaml创建workmux add branchworktree tmux 窗口一步到位分发任务/worktree 任务委托给并行 Agent技能监控workmux list/workmux dashboard状态一览 / 交互看板同步基线workmux rebase把分支 rebase 到保存的基分支恢复workmux open name/workmux resurrect重开窗口 / 崩溃后恢复合并workmux merge合并 清窗口 删 worktree 删分支弃掉workmux remove --keep-branch只删环境保留分支批量清理workmux rm --all/--gone全清 / 清理已合并更多模式会话模式、命名布局、沙箱运行 Agent 等可查阅 官方文档指南 与 工作流参考。写在最后workmux 的设计哲学是构建在你已有的工具上tmux 负责窗口、git 负责 worktree、你的 Agent 负责写代码它只负责把三者无缝粘合成一条从add到merge的零摩擦流水线。当并行任务从 1 个变成 5 个你会真切体会到上下文切换的成本应该只等于切一个标签页 【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考