agent-tui
让AI智能体自动化操作终端界面(TUI)应用的CLI工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-tui。 它的用途是：让AI智能体自动化操作终端界面(TUI)应用的CLI工具。 完整的 Skill 内容见：https://321skill.com/skills/agent-tui/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我启动agent-tui守护进程，然后在其中运行`htop`监控系统资源。”，它会执行`agent-tui daemon start`并启动htop。接着你可以说：“截一张当前htop的屏幕图给我看。”，AI会调用`screenshot`命令获取终端状态图像，供你或后续分析使用。
介绍
agent-tui 解决了AI智能体难以与终端用户界面(TUI)应用交互的难题。它通过创建一个虚拟终端环境，让AI能够像人类一样“看到”终端屏幕并发送键盘指令，从而实现对htop、vim、tmux等TUI应用的自动化控制。
使用时，你需要先启动一个守护进程，然后通过agent-tui命令行工具向AI智能体暴露的接口发送指令。AI智能体可以请求截图来“观察”终端状态，并通过发送按键、输入文本等指令来“操作”应用，整个过程可以通过WebSocket进行实时监控。
它非常适合需要将传统TUI应用集成到自动化流程中的智能体开发者、运维工程师和测试人员。例如，开发一个能自动监控服务器状态或进行系统配置的AI智能体。
需要注意的是，该工具目前仅支持Unix-like系统（如Linux、macOS），不支持原生Windows环境。使用时需确保系统具备PTY、Unix域套接字等能力，并注意管理好会话状态文件。
核心特点
与仅能处理纯文本输出的传统终端自动化工具不同，agent-tui通过虚拟终端和截图能力，让AI能“看到”并操作任何基于像素的TUI界面，解决了ncurses等库构建的复杂界面自动化难题。同时，它专为AI智能体设计，提供了JSON-RPC over WebSocket等接口，便于与LLM驱动的Agent无缝集成。
注意事项
仅支持Unix-like系统（Linux、macOS等），不支持原生Windows环境及其相关生态。
常见问题
agent-tui能在Windows上使用吗？
不能，它依赖Unix特有的PTY和域套接字，是Unix-only工具。
它和expect或screen有什么区别？
expect基于文本模式，而agent-tui通过截图“视觉化”操作TUI；screen是终端复用器，而agent-tui是供外部AI智能体驱动终端的自动化接口。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-tui/raw/index.md 读取 agent-tui 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-tui/raw/index.md（查看排版版本）