Skip to content

tmux Integration zh CN

ChrAlpha edited this page Nov 12, 2026 · 3 revisions
🇬🇧English | 🇨🇳中文

tmux 集成

  • 提醒。 Agent 在你当前没有查看的 pane 中开始等待回应或完成一个 turn 时,所在 window 会出现 tmux bell 标记(!),前提是 monitor-bell 为 on,即默认值。tmux 原有的 prefix + M-n / M-p 即可在这些 windows 间跳转。
  • prefix + A 跳到等待最久的 agent,先处理 blocked,再处理 idle。
  • prefix + a 打开运行 agents 的 pane 树,并显示状态。
  • #{tmag_status} 放在 status-left / status-right 中,显示 2 blocked · 1 working。
  • #{E:@tmag-pane-status} 放在 pane-border-format 中,为每个 pane 显示标签,例如 claude working、codex blocked permission。

配置项

配置项 默认值 作用
@tmag-key-picker a 打开 agent 树的 prefix 快捷键。
@tmag-key-jump A 跳到等待最久的 agent 的 prefix 快捷键。
@tmag-key-setup M-a 接入 agents 并检查安装的 prefix 快捷键。
@tmag-key-serve M-r 在 window 中启动本地 HTTP API,或提示现有实例位置的 prefix 快捷键。
@tmag-serve 未设置 prefix + M-r 传给 tmag serve 的参数,见 HTTP API。
@tmag-alert blocked,finished 哪些状态变化触发 pane bell 和 @tmag-notify。
@tmag-notify 未设置 离开终端时接收提醒的命令,见通知。
@tmag-answer on 谁可以在 agent 自身对话框之外通过 tmag answer 回应 permission prompts 和问题:on 仅允许用户;agents 也允许 agents;off 全部关闭。
@tmag-peers on prefix + M-a 是否为 agents 安装协作用的 tmag-peers skill;off 会将其移除。
@tmag-release-url GitHub releases Binary 下载地址,可用于镜像。

将快捷键配置设为 off 可取消对应绑定;将 @tmag-alert 设为 off 可关闭 bell 提醒;将 @tmag-answer 设为 off,请求就只能在 agent 内回应。

将 @tmag-peers 设为 off 后,再按 prefix + M-a,即可从 agents 的上下文中移除 tmag 的 skill。所有配置项都应放在 TPM 的 run 行之前。

Clone this wiki locally