workmux Pane 布局完全指南自定义你的 tmux 并行工作区【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmuxworkmux 是一款把 git worktrees 与 tmux 结合的并行开发工具每个任务独立一个 tmux 窗口多个 AI 代理Agent互不干扰地同时工作。本文带你从零配置 workmux 的 Pane 布局pane layout——用一份 YAML 就能决定每个窗口里有哪些分屏、谁拿焦点、尺寸多大再通过常驻 sidebar 一眼掌握全部代理状态打造真正属于你自己的 tmux 并行工作区。为什么 workmux 适合并行开发 用 worktrees 并行开发最大的痛点是环境切换stash、切分支、重启 dev server……workmux 的思路是一个任务一个窗口并行工作流workmux add一条命令同时创建 git worktree 和对应的 tmux 窗口各自独立运行自动化初始化自动复制.env、软链接node_modules、在 Pane 里执行安装命令新 worktree 开箱即用一键收尾workmux merge自动合并分支、清理 worktree、关闭窗口。如果你还没有安装可以先克隆仓库 https://link.gitcode.com/i/c0b4505da588d92a134a1dd6691d555a 按官方说明安装也支持 Homebrew、Cargo、Nix 等方式。快速开始三步创建你的第一个并行工作区# 1. 在项目里初始化配置可选按需跳过 workmux init # 2. 创建名为 new-feature 的 worktree tmux 窗口 workmux add new-feature # 3. 完工后一条命令合并并清理 workmux mergeworkmux add执行时会依次创建 worktree → 复制/软链接配置文件 → 运行初始化钩子 → 按你配置的Pane 布局搭建窗口 → 自动切到新窗口。第 4 步的 Pane 布局就是本文的主角。panes 配置tmux Pane 布局定制的核心在全局配置~/.config/workmux/config.yaml或项目根目录的.workmux.yaml中用panes数组描述每个窗口的分屏方案panes: - command: agent # 第一个 Pane 运行 AI 代理 name: agent focus: true # 打开窗口后焦点落在这里 - command: npm run dev # 第二个 Pane 横向切出跑开发服务器 name: dev split: horizontal size: 15 # 只占 15 行每个 Pane 支持的常用选项选项作用默认值command要运行的命令支持agent占位符Shellsplit切分方向horizontal上下/vertical左右—focus该 Pane 是否获得初始焦点falsesize/percentage绝对行列数 / 百分比1-10050%target从第 N 个 Pane0 起切分而非最近一个最近 Panezoom全屏显示该 Pane隐含focus: truefalse两个实用技巧agent占位符解析为全局agent配置项如claude、codex内置代理会被自动识别并注入任务 prompttarget指定切分来源比如「上面两个 Pane、下面一个整宽 Pane」的经典布局用target: 0让新 Pane 从最上面切出即可。命名布局 layouts一套配置反复复用 不同任务想换不同的 Pane 组合把布局存成「命名布局」创建时一行指定layouts: design: panes: - command: agent focus: true - command: agent:codex split: vertical # 双代理左右对坐 review: panes: - command: agentworkmux add my-feature -l design-l会用该布局的panes替换顶层配置其余设置钩子、文件操作等照常生效——改一份配置所有 worktree 布局统一是团队协作时的推荐做法。Session 模式一个 worktree 多个窗口默认情况下 workmux 为每个 worktree 创建一个 tmux 窗口若一个任务本身需要多个窗口如「编辑器 测试」各一窗在配置里切换为 session 模式并用windows数组为每个窗口单独定义 Pane 布局mode: session windows: - name: editor panes: - command: agent focus: true - split: horizontal size: 20 - name: tests panes: - command: just test --watch常驻 sidebar并行代理状态一目了然 ⚡窗口多了以后靠 tmux 状态栏来回翻窗口找「哪个代理在等我」并不高效。workmux sidebar会在每个 tmux 窗口的左边缘或顶边固定一块实时状态栏列出全部代理的状态图标、worktree 名、耗时、git 变更量甚至 PR 编号与检查状态workmux sidebar # 开启/关闭全局所有会话 workmux sidebar --session # 仅当前会话 workmux sidebar --position top # 临时改为顶部横条左侧栏 vs 顶部横条position: left默认竖排卡片width支持绝对列数或百分比如15%position: top横排芯片chip用height行数和horizontal.item_width控制行高越大显示的信息行越多。按项目分组与折叠多仓库并行时group_by可以把代理按项目或会话分区显示过期的闲置代理自动折叠成一行列表始终保持清爽sidebar: group_by: project # 按仓库分组也可用 session collapse_stale: true # 分组内折叠过期代理快捷键速查快速跳转与切换 Pane ⌨️sidebar 获得焦点时按键动作j/k上下选择代理Enter跳转到该代理所在 Panev切换瓷砖 / 紧凑布局t切换分组 / 平铺z标记当前代理为「休眠」沉底降权在任意 Pane 里也能直接命令行切换workmux sidebar next # 下一个代理循环 workmux sidebar jump 3 # 跳到第 3 个配合 tmux 绑定免 prefix 直按例如bind -n M-j run-shell workmux sidebar next、bind -n M-1 run-shell workmux sidebar jump 1多窗口间的穿梭就和按 Tab 一样自然。配置文件与延伸阅读全局配置~/.config/workmux/config.yamlworkmux config edit可直接打开编辑项目配置.workmux.yaml项目级设置按字段覆盖全局Pane 布局完整选项docs/src/content/docs/guide/configuration.mdsidebar 官方文档docs/src/content/docs/guide/sidebar/index.mdxsidebar 模板深度定制自定义显示哪些字段docs/src/content/docs/guide/sidebar/customization.md命令参考docs/src/content/docs/reference/commands/sidebar.mdsidebar 实现源码src/command/sidebar/、仪表盘实现src/command/dashboard/掌握panes、layouts与 sidebar 三件套后你的 tmux 并行工作区就从「能跑」进化到「顺手」布局随任务而变状态永远在眼前。【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考