workmux Sidebar 详解常驻侧边栏实时掌握所有 AI Agent 状态【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmuxworkmux 的 Sidebar常驻侧边栏是并行开发工作流中最实用的一块仪表盘它把每个 AI Agent 的状态、代码改动和 PR 进度实时钉在 tmux 窗口的边缘让你无需切换窗口就能一眼掌握所有正在跑的 Claude、Codex、Gemini 等 Agent。本文带你快速上手这个功能。为什么需要 workmux Sidebar当你同时跑多个 AI Agent 时最痛苦的事是切到某个窗口才发现这个 Agent 早就在等你确认而那个已经跑完的 Agent 没人认领。workmux 有两种监控方式Sidebar 是最适合边干活边看的那一个对比项workmux Dashboardworkmux Sidebar形态全屏 TUI按需打开小面板常驻窗口边缘占用空间整个终端左侧一条 / 顶部一行适合场景深度检查、批量操作随时扫一眼、快速跳转⚠️ Sidebar 目前仅支持 tmux 后端且需要配置好 状态跟踪 hooks。一键开启最简单的启动命令在任意 shell 中执行workmux sidebar # 全局开启所有 tmux 会话 workmux sidebar --session # 仅当前会话开启 workmux sidebar --position top # 临时改为顶部横条再执行一次即关闭。推荐顺手加一个 tmux 快捷键bind C-t run-shell workmux sidebar每个 Agent 卡片上显示什么每个 Agent 渲染为一张卡片tile包含状态图标working 旋转动画 / waiting / done / sleeping worktree 名称 距上次状态变化的耗时项目名 git 改动统计已提交与未提交的增删行数PR 编号与 check 状态若当前分支有 PRAgent 任务描述配置指南位置、宽度与分组在全局~/.config/workmux/config.yaml或项目.workmux.yaml中配置sidebar: position: left # left默认或 top width: 40 # 左侧栏宽度列数也可写 15% layout: tiles # tiles卡片或 compact单行 dim_stale: true # 一小时无变化的 Agent 自动变暗 sort: recency # recency / priority / window group_by: project # 按项目或会话分组默认不分组 collapse_stale: true # 分组时把陈旧的 Agent 折叠起来几个实用要点排序priority模式会把等待中 / 已完成的 Agent 永远置顶适合多人协作 Agentwindow模式则让行位置固定不跳动。顶部横条position: top时每个 Agent 变成一个横向芯片一行显示多个sidebar: position: top height: 3 horizontal: item_width: 24分组group_by: project会把 Agent 按仓库分节显示节头显示数量配合collapse_stale: true没有活跃工作的项目只占一行非常清爽。键盘操作速查表侧边栏获得焦点后就像切到普通 tmux 窗格一样切过去常用按键如下按键功能j/k上下选择 AgentEnter跳转到该 Agent 的窗格g/G跳到第一个 / 最后一个v切换 tiles / compact 布局f只看当前会话的 Agentt切换分组 / 平铺z将选中 Agent 标记为休眠沉底?显示帮助全局 Agent 导航快捷键不必聚焦侧边栏在任意窗格都能用命令行切换 Agent顺序与侧边栏一致workmux sidebar next # 下一个 Agent循环 workmux sidebar prev # 上一个 Agent workmux sidebar jump 2 # 跳到第 2 个配合 tmux 绑定体验直接拉满# Altj / Altk 循环切换无需 prefix bind -n M-j run-shell workmux sidebar next bind -n M-k run-shell workmux sidebar prev # Alt1..9 直接跳转 bind -n M-1 run-shell workmux sidebar jump 1还支持鼠标开启set -g mouse on后点击卡片即跳转滚轮可滚动列表。深入自定义模板、图标与配色Sidebar 的每行内容都由一套 token 模板渲染支持{status_icon}、{primary}、{git_stats}、{pr_number}、{pr_checks}、{elapsed}等 20 多个字段还能用 tmux 风格的#[fgcyan,bold]指令调色sidebar: templates: tiles: - {agent_icon} {primary} {fill} {elapsed} - {secondary} {fill} {git_stats} - {pane_title} {fill} {pr_number} {pr_checks}其中{agent_icon}会自动识别正在跑的 Agent 并显示品牌图标与配色Claude 显示CC橙色、Codex 显示CX青色、Gemini 显示G蓝色……想改样式在sidebar.agent_icons下逐 Agent 覆盖即可。完整 token 列表与转义规则见官方文档侧边栏指南docs/src/content/docs/guide/sidebar/index.mdx模板与配色自定义docs/src/content/docs/guide/sidebar/customization.md命令参考docs/src/content/docs/reference/commands/sidebar.md它是如何做到零卡顿的Sidebar 内部采用daemon client架构源码见 src/command/sidebar/开启时在每个窗口的左/上边缘创建侧边栏窗格启动后台守护进程并安装 tmux hooks新窗口自动加侧边栏、窗口切换即时刷新。守护进程每 2 秒轮询一次 tmux 状态收到信号则立即刷新通过 Unix socket 把快照推给所有侧边栏窗格。每个窗格独立渲染进程只在有新数据或需要转动动画时才醒来空闲时 CPU 占用接近零。资源消耗也很克制每个窗格进程约 15 MB 内存守护进程约 16 MB跑 5 个 Agent 总占用大约 90 MB。写在最后workmux Sidebar 把我开了 5 个 Agent现在都到哪一步了这个高频问题压缩成了一眼的事。先跑workmux sidebar体验默认配置再按需调整position、group_by和模板即可获得一个既省地方又信息密度极高的实时监控面板。【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考