workmux Agent 状态追踪完全指南如何把实时状态显示在 tmux 窗口名【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmuxworkmux是一个把 git worktrees 和 tmux 窗口结合在一起的并行开发工具支持对多个 AI 编程 Agent 进行Agent 状态追踪它会在每个 tmux 窗口名旁实时显示 工作中、等待输入、✅已完成三个状态图标让你一眼看清所有 Agent 正在干什么、谁需要你的关注。为什么需要 Agent 状态追踪当你用 workmux 同时启动多个 Agent 并行开发时最常遇到的问题是谁干完了谁卡住了谁在等我确认没有状态追踪时你只能逐个切换窗口查看。有了 workmux 的 Agent 状态追踪只需瞄一眼 tmux 底部状态栏或 Zellij 标签栏每个窗口旁的图标就回答了所有问题图标含义自动行为Agent 正在工作持续到状态变化Agent 等待你的输入你切到该窗口后自动清除✅Agent 已完成你切到该窗口后自动清除 状态不仅显示在状态栏还会同步到 workmux 的 dashboard 和 sidebar三处视图始终一致。支持的 Agent 一览workmux 已为主流 CLI Agent 内置状态追踪支持覆盖几乎所有常见选择Agent支持情况备注Claude Code✅完整三态OpenCode✅完整三态Codex✅首轮开始后才注册状态Gemini CLI✅完整三态Grok✅完整三态Oh My Pi✅完整三态Copilot CLI⚠️无 等待态Pi⚠️无 等待态Antigravity CLI (agy)⚠️无 等待态官方文档详见 status-tracking.mdx。一键安装workmux setup 三步搞定第一步运行 setup 命令workmux setupworkmux 会自动检测你机器上安装了哪些 Agent CLI检查可执行文件或配置目录然后交互式地为它们安装状态追踪 hooks同时顺带安装 skills。如果检测到某个 Agent 还没配置追踪首次运行时它也会主动提示你。第二步自动适配 tmux 状态栏格式setup 会自动修改当前 tmux 会话的window-status-format让workmux_status变量渲染到状态栏上——只影响当前会话不会动你的全局~/.tmux.conf。第三步重启 Agent部分 Agent如 Antigravity、OpenCode在会话启动时加载 hooks安装后重启对应 Agent 即可看到窗口名旁边的状态图标。状态图标是如何显示的原理揭秘整个追踪链路非常优雅值得给好奇的你简单拆解一下hooks 上报Agent 的 hooks如 Claude Code 的UserPromptSubmit、Stop事件在关键节点调用workmux set-window-status working|waiting|done。核心命令的状态枚举定义在 set_window_status.rs。写入 tmux 变量workmux 把图标写入窗口级选项workmux_status供状态栏显示和窗格级选项workmux_pane_status供 sidebar 区分同一窗口内的多个 Agent实现逻辑在 tmux.rs。聚焦自动清除对 和 ✅ 状态workmux 会注册pane-focus-in钩子——你切进该窗格的瞬间图标自动消失避免已读未处理的视觉噪音。状态持久化每次状态更新同时写入本地状态存储供workmux status、dashboard 和 sidebar 读取并通知 sidebar 刷新。中断检测如果 Agent 处于 状态但窗格输出超过 10 秒没有变化比如你按了 CtrlCworkmux 会自动将其标记为已中断让你知道它卡住了。配套能力从状态图标到快速跳转看到 ✅ 和 只是第一步workmux 还提供了两个高频命令workmux last-done跳到最近完成或正在等待输入的 Agent反复执行可逐个轮询所有待处理 Agent。加个 tmux 键位bind l run-shell workmux last-done按prefix l即可秒跳。workmux last-agent在当前 Agent和上次访问的 Agent之间来回切换类似 vim 的Ctrl^在 dashboard 中按Tab同样可用。不止 tmuxZellij / Kitty / WezTerm 同样支持workmux 的状态追踪基于统一的 Multiplexer 抽象除 tmux 外还支持 Zellij显示在标签标题、Kitty 和 WezTerm。注意 Zellij 不会在聚焦标签时自动清除图标而是由下一次状态更新自然覆盖。进阶技巧自定义图标在~/.config/workmux/config.yaml中通过status_icons替换默认图标还支持 tmux 颜色码给图标上色status_icons: working: waiting: ⏸️ done: #[fg#a6e3a1]#[fgdefault]自己管理状态栏格式设status_format: false关闭自动修改然后手动在~/.tmux.conf中加入workmux_status变量。嵌套 Agent 防干扰在 Agent 里再启动另一个 Agent 时给内层命令加上WORKMUX_DISABLE_SET_WINDOW_STATUS1只让外层窗格驱动状态图标。手动安装 hooks不想用 setup 的 Agent 可以手动安装例如 Claude Code 插件见 agent_setup/claude.rs 中检测的workmux-status插件Codex / Gemini / OpenCode 等的手动步骤在 README 的 Agent status tracking 章节有完整说明。相关文件路径模块说明src/command/set_window_status.rs状态上报命令与窗格解析src/command/setup.rssetup 命令自动检测并安装 hookssrc/multiplexer/tmux.rstmux 后端状态变量与自动清除钩子src/agent_setup/各 Agent 的 hooks 安装逻辑docs/src/content/docs/guide/status-tracking.mdx官方状态追踪文档tests/test_workmux_setup.pysetup 流程的集成测试装好workmux setup之后你的 tmux 状态栏就多了一排Agent 信号灯——并行开发从此不用再挨个窗口翻找看到 ✅ 就去收菜看到 就去回复专注度直接拉满 【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考