终端会话自动化编排专家

Clawdbot 官方维护的 tmux 终端会话远程控制工具，通过本地 socket 实现交互式 CLI 自动化，支持多代理并行编排与输出捕获，为开发者提供安全隔离的终端自动化能力。

基本信息

• 技能名称?tmux
• 中文名称?终端会话自动化编排专家
• 作者?steipete
• 分类?开发
• 版本?v1.0.0
• 标签?devops, automation, development-engineering, backend, testing, productivity

使用方法

使用说明
核心用法
tmux Skill 是 Clawdbot 组织开发的终端复用器控制工具，专为需要交互式 TTY 的场景设计。其核心能力包括：通过 Unix socket 创建隔离的 tmux 会话、向指定 pane 发送按键序列、捕获会话输出内容，以及编排多个编码代理并行工作。典型工作流为：创建命名会话 → 启动交互式程序（如 Python REPL、Node.js CLI）→ 发送命令输入 → 轮询捕获输出 → 清理会话。特别适用于 Codex、Claude Code 等 AI 编码代理的批量任务分发与结果收集。
显著优点
隔离性与安全性 ：采用专用 socket 目录（ CLAWDBOT_TMUX_SOCKET_DIR ）实现会话隔离，避免与系统 tmux 冲突；所有通信通过本地 Unix socket 完成，零网络暴露风险。 自动化能力突出 ： wait-for-text.sh 脚本支持正则匹配轮询，可精准等待特定输出模式； send-keys 支持字面量与控制键混合发送，覆盖完整交互场景。 并行编排效率 ：文档详细展示多代理并发模式，配合 git worktree 可实现大规模代码任务的分布式处理，显著提升开发效率。 工程规范完善 ：脚本统一使用 set -euo pipefail ，参数验证严格（正则校验整数、必填项检查），错误处理到位。
潜在缺点与局限性
平台限制严格 ：仅支持 macOS 与 Linux，Windows 必须依赖 WSL 层，增加了跨平台协作成本。 依赖外部工具 ：功能完全绑定系统 tmux，若未安装或版本不兼容则无法运行。 交互复杂性 ：相比纯 bash 后台模式，tmux 引入额外的会话生命周期管理，调试难度更高；非基础 Python REPL 的复杂终端特性可能破坏按键发送流程。 权限管理隐性成本 ：socket 文件权限由操作系统控制，多用户环境需额外关注访问隔离，文档虽提及但未给出具体权限配置方案。
适合的目标群体
AI 辅助开发工程师 ：需要同时驱动多个 Codex/Claude Code 实例处理批量代码任务的用户。 自动化测试开发者 ：构建交互式 CLI 工具（数据库客户端、REPL 环境）的自动化测试流水线。 DevOps 与 SRE ：管理远程服务器上需要保持会话状态的长期运行任务。 科研与数据工程师 ：在隔离环境中运行 Jupyter 替代方案或交互式数据分析会话。
使用风险
命令执行风险 ： send-keys 功能本质是将按键注入 tmux 会话，间接具备执行任意 shell 命令的能力，需确保输入来源可信。 会话残留风险 ：异常退出可能导致 tmux 会话和 socket 文件残留，长期积累消耗系统资源，需建立定期清理机制。 输出截断风险 ： capture-pane 的 -S 参数控制历史行数，设置不当可能导致关键输出丢失；高频率轮询可能产生性能开销。 并发竞争风险 ：多代理并行写入同一 socket 时，极端情况下可能出现会话状态竞争，建议按业务域拆分 socket 实例。