工程开发
tmux avatar

tmux

远程控制 tmux 会话,通过发送键盘指令、监控输出及管理窗格与窗口,以自动化交互式 CLI 工具。

简介

tmux 技能为 OpenClaw 环境中的代理程序提供了一个强大的接口,以便与长时间运行的终端应用程序进行交互。它的设计旨在作为助手与交互式命令行接口 (CLI)(如 Claude Code、Shell 脚本或后台开发任务)之间的桥梁。通过抽象化 tmux 会话、窗口和窗格的复杂性,此技能允许对无头或持久的终端环境进行细粒度控制,确保自动化工作流程在断线后仍能保持稳定。

  • 精确的输入传递:向任何目标 tmux 窗格发送特定的键盘指令、标准文本或控制序列(如 Ctrl+C、Ctrl+D 或 Enter)。

  • 输出可观测性:实时截取窗格滚动缓冲区,以分析处理程序状态、监控错误日志或解析交互式提示。

  • 会话生命周期管理:通过编程方式创建、重命名、列出和终止 tmux 会话,以维护有组织的工作空间环境。

  • 导航控制:使用索引目标 (session:window.pane) 在 tmux 窗口和特定窗格之间动态切换。

  • 交互式自动化:监控终端输出中的特定模式或状态变化,以触发自动响应,例如批准提示或继续长时间运行的构建任务。

  • 此工具最适合代理程序必须在终端中维持状态持久性的情境,例如调试、持续集成或运行交互式助手。

  • 使用 capture-pane -p 命令直接截取数据,以进行后续处理或代理程序决策。请始终使用 session:window.pane 格式以避免输入错误。处理交互式 TUI 时,请将文本输入与 Enter 键以短暂延迟分开,以防止输入缓冲或多行边缘情况。请注意,此技能不适用于一次性的 Shell 执行;对于简单的非交互式命令,建议改用系统 exec 工具。始终确保目标 tmux 会话存在后再发送命令,以防止执行失败。

仓库统计

Star 数
365,899
Fork 数
75,022
Open Issue 数
6,951
主要语言
TypeScript
默认分支
main
同步状态
空闲
最近同步时间
2026年4月29日 01:33
在 GitHub 查看