工程开发
tmux avatar

tmux

远程控制 tmux 会话,通过发送自动化按键与抓取终端面板输出,以实现 CLI 的自动化操作。

简介

tmux 技能为程序化互动终端机多工器会话提供了强大的接口。它专为需要管理、监控与互动长时间执行之 CLI 应用程序(如 Claude Code、Codex 或其他互动式构建与调试工具)的代理人所设计。透过利用 tmux 在 SSH 连接或终端机关闭后仍能保持进程分离与持续执行之特性,此技能确保您的自动化工作流程无论主机连接状态如何,皆能保持稳定且可观测。

  • 透过发送原始文字或特定控制序列(如 Ctrl+C、Enter、Escape)至活动终端机面板,实现精确的输入传递。

  • 从特定的 tmux 窗口与面板进行即时输出抓取与屏幕提取,使代理人能针对 CLI 提示、错误消息或状态更新做出即时反应。

  • 无缝的窗口与面板导航,允许代理人在平行的背景会话与主要接口之间切换操作环境。

  • 完整的状态管理功能,包含列出、创建、重新命名与终止会话,以维持整洁的开发环境。

  • 透过分割文字输入与执行指令,安全处理互动式 TUI(终端机用户接口)提示,有效避免粘贴错误与多行格式化问题。

  • 在执行指令前,请务必确认目标会话识别码格式 (session:window.pane),以确保输入传送至正确的工作区。

  • 使用 capture-pane -p 指令将输出直接导向日志或剖析函数;查看历史进程日志时,可使用 -S - 来抓取完整的滚动缓冲区。

  • 虽然此技能对于互动式 CLI 操作非常强大,但请勿将其用于简单的单次 Shell 脚本;请利用标准的 exec 工具进行非互动式指令,以减少额外开销。

  • 若要检测会话是否需要响应,可将抓取的输出导入正则表达式过滤器,以搜索互动指标如 ❯、权限请求或继续执行提示。

  • 会话可自动保持,使其成为管理背景工作、长时间执行之部署任务及平行化 CLI 任务的理想选择。

仓库统计

Star 数
366,073
Fork 数
75,055
Open Issue 数
6,981
主要语言
TypeScript
默认分支
main
同步状态
空闲
最近同步时间
2026年4月29日 08:03
在 GitHub 查看