shux
专为AI编码代理设计的终端复用器
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:shux。 它的用途是:专为AI编码代理设计的终端复用器 完整的 Skill 内容见:https://321skill.com/skills/shux/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用 shux 创建一个名为 ‘debug’ 的会话,并在其中运行项目构建命令。”,AI 代理可以通过调用 `session.create` RPC 创建会话,然后使用 `pane.send_keys` 发送构建命令。或者,开发者可以在脚本中直接使用 `shux session create debug` 和 `shux pane send-keys -s debug --text 'make build'` 来实现自动化。
介绍
shux 是一款专为 AI 编码代理设计的现代终端复用器,旨在解决传统工具(如 tmux)在程序化控制方面的不足。它通过提供类型化的 JSON-RPC API,让 AI 代理能够像人类一样精确地创建、管理和操作终端会话、窗格和窗口,实现人机操作的完全对等。
使用上,shux 提供了与 RPC 方法一一对应的命令行接口,用户或代理可以通过简单的命令(如 shux session create work)创建会话,或通过 shux rpc call 直接调用底层 RPC 方法。它还支持生成窗格的 PNG 快照和录制精确的 PTY 字节流,便于代理观察和记录终端状态。
它非常适合需要将终端操作自动化、集成到 AI 代理工作流中的开发者和 AI 工程师。无论是构建 AI 驱动的开发工具、自动化测试脚本,还是需要程序化控制多终端环境的场景,shux 都能提供稳定、可查询和确定性的状态管理。
需要注意的是,shux 目前主要支持类 Unix 系统(macOS, Linux),且其 PNG 快照功能依赖于内置的字体链。用户可以通过配置文件自定义外观,但通常默认配置已为常见的 TUI 输出提供了良好的支持。
核心特点
与 tmux 等传统复用器不同,shux 从设计之初就将 AI 代理视为一等公民,提供了类型化的 JSON-RPC API 用于程序化控制,确保每个操作(无论是键盘还是 API)都能获得确定性的、可查询和可流式传输的状态,无需任何包装层。
注意事项
目前主要适用于类 Unix 操作系统(如 macOS 和 Linux),且其程序化控制特性在纯人工交互场景下可能不如传统工具直观。
常见问题
shux 和 tmux 有什么区别?
shux 专为 AI 代理设计,提供类型化 API 和确定性状态,支持程序化控制;tmux 主要为人类交互设计,缺乏原生的程序化 API。
如何让 AI 代理控制 shux?
AI 代理可以通过调用与 CLI 命令一一对应的 JSON-RPC 方法(如 `session.create`)来操作 shux,或直接使用 `shux rpc call` 命令。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/shux/raw/index.md 读取 shux 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/shux/raw/index.md(查看排版版本)