smux

为AI Agent设计的终端自动化与协作工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:smux。
它的用途是:为AI Agent设计的终端自动化与协作工具
完整的 Skill 内容见:https://321skill.com/skills/smux/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请使用tmux-bridge检查名为‘server’的窗格中最近的错误日志,并在‘code’窗格中修复相关代码。” 它会先读取server窗格的输出定位问题,然后切换到code窗格,键入修复命令并执行。整个过程无需你手动切换窗格或复制粘贴。

介绍

smux 是一个专为AI Agent设计的终端自动化与协作工具,它解决了AI Agent在终端环境中难以观察、交互和协作的痛点。通过一个增强的tmux配置和一个名为tmux-bridge的CLI工具,它让AI Agent能够像人类一样“看到”终端内容、输入命令并控制不同的终端窗格。

使用时,用户只需一键安装脚本,即可获得一个预配置好的tmux环境。AI Agent(如Claude Code、Cursor等)可以通过tmux-bridge命令来读取指定终端窗格的内容、向其中输入文本或发送按键(如Enter),从而实现跨窗格的自动化操作与协作。例如,一个负责代码生成的Agent可以命令另一个负责代码审查的Agent在相邻窗格中工作。

这个工具非常适合需要让AI Agent在本地终端环境中执行复杂、多步骤任务的开发者或高级用户。无论是自动化部署、代码审查、系统监控还是多步骤的调试流程,都可以通过smux让多个AI Agent在同一个终端会话中协同完成。

与同类终端自动化工具(如expect脚本或仅面向人类的tmux插件)相比,smux的核心区别在于其设计初衷是“为AI而生”。它提供了标准化的CLI接口,使任何能运行bash的AI Agent都能轻松接入,并内置了对多Agent协作场景的原生支持,例如为窗格命名以便Agent间相互寻址。

核心特点

核心区别在于其专为AI Agent协作而设计,提供了标准化的`tmux-bridge` CLI接口,使得任何能运行bash的Agent都能轻松读取、控制终端窗格,并支持通过窗格标签进行Agent间的直接寻址与通信,实现了真正意义上的多Agent终端协作工作流。

注意事项

目前仅支持macOS(需Homebrew)和Linux系统,且不适用于Windows原生环境或不需要终端多窗格协作的简单自动化场景。

常见问题

smux和普通的tmux配置有什么区别?

smux在提供优化键绑定的同时,核心是增加了`tmux-bridge`工具,让AI Agent能通过命令行与任何tmux窗格交互,这是普通配置不具备的。

哪些AI Agent可以使用smux?

任何能够执行bash命令的AI Agent都可以使用,例如Claude Code、Cursor、GitHub Copilot Chat以及通过技能系统集成的40多种其他Agent。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/smux/raw/index.md 读取 smux 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。