- name
- smux
- description
- Cross-pane messaging for tmux. Use
tmux-bridgecommand to send messages between panes labeled p1, p2, p3... - version
- 1.0.0
- metadata
smux
多 pane 协作技能。通过 p1, p2, p3 标签与其他 pane 通信，无需记忆 pane ID。
快速开始
# 从普通 shell 启动三 pane 工作台
tmux-bridge -l mysession
# 查看当前 session 的 panes
tmux-bridge list
# 收到任务后，先判断当前消息是不是来自其他 agent
tmux-bridge pending
# 需要对方回传结果时显式声明
tmux-bridge send --expect-reply p1 '请分析 src/auth.ts'
# 仅通知，不要求回复
tmux-bridge send --no-reply p1 '我先去跑测试'
# 收到待回复任务后回传最终结论
tmux-bridge reply '分析完成：...'命令
| 命令 | 用途 |
|---|---|
launch / -l <session_name> [delay_secs] | 从外层 shell 创建新的三 pane session，并自动 attach |
kill-session / -k <session_name> | 按 session 名快速关闭整个 tmux session |
list | 列出当前 session 的所有 pane 和标签 |
send --expect-reply <target> <msg> | 发送需要回传结果的消息 |
send --no-reply <target> <msg> | 发送不需要回传的消息 |
pending | 查看当前 pane 未处理的待回复消息，状态为 waiting 或 overdue |
reply <msg> | 回复当前 pane 最近一条待回复消息 |
rename | 将当前 session 所有 pane 重命名为 p1, p2, p3... |
auto-label | 输出自动命名配置脚本 |
Agent 协作准则
- 在生成最终回复前，先执行
tmux-bridge pending判断当前 pane 是否有待回复消息。 - 如果
pending显示waiting或overdue，说明当前任务来自其他 agent，最终结论必须用tmux-bridge reply '<结论>'回传。 - 如果
pending没有待回复项，视为普通用户输入，不需要调用reply。 - 给其他 agent 发任务时，默认使用显式模式：
- 需要结果时用 --expect-reply - 只是通知时用 --no-reply
- 禁止回传“收到”“正在处理”“谢谢”这类无效内容；即使没有发现，也要明确回复“无发现”。
- 如果
tmux-bridge reply报错no pending reply target for this pane，说明当前没有可自动回复的对象，此时再手动使用tmux-bridge send --no-reply <target> '<结论>'。
自动命名（推荐）
开启后，新创建的 pane 自动获得 p1, p2 标签：
# 添加配置到 tmux.conf
tmux-bridge auto-label >> ~/.tmux.conf
tmux source-file ~/.tmux.conf使用原则
- 外层创建/关闭 session 优先使用
tmux-bridge -l和tmux-bridge -k pending是判断消息来源的唯一依据，不要靠目测 pane 输出猜测- 发 agent 消息时不要手搓
send-keys - 标签优先：用
p1代替%42 reply只用于处理--expect-reply建立的待回复消息