workmux Agent 状态追踪完全指南：如何把实时状态显示在 tmux 窗口名-北京尧图网络

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），仅供参考

workmux Agent 状态追踪完全指南：如何把实时状态显示在 tmux 窗口名

相关推荐

TFLite内存规划器深度解析：从生命周期到Arena复用，让移动端推理内存省一半

DoTA交通事故视频数据集：光流+轨迹标注的异常驾驶检测专用资源

LSTM时间序列预测最小可行系统：Excel导入→训练→可视化全流程

更多资讯

JavaWeb问卷调查系统全解析：从部署到改造的实战指南

Steam商店网络优化全指南：从DNS到CDN再到QoS的完整排查思路

Unreal Engine Volume GI 实战指南：体素光照优化与信创适配

大模型辅助3D游戏开发：Minecraft模组实测与工程化落地指南

Java Web新闻发布系统：Servlet+JSP+MySQL零配置实战

Linux下Eigen、OSQP与OSQP-Eigen安装指南：CMake链接避坑实战

今日更新

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

本周精选

如何彻底离线使用 Laya-CoreML：Hugging Face 下载、缓存机制与 local_files_only 详解

基于1Panel 部署MySQL MCP 服务：TaoToken 统一 Key 接入与 config.toml 配置实战

崇州园区营销网站建设避坑指南：5大注意事项保备案安全

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？