tmux

核心用法

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 实例。