pilotty

让AI智能体像人一样操作终端TUI应用的自动化CLI工具。

安装使用

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

帮我安装这个 AI Skill:pilotty。
它的用途是:让AI智能体像人一样操作终端TUI应用的自动化CLI工具。
完整的 Skill 内容见:https://321skill.com/skills/pilotty/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“请使用pilotty启动一个vim会话,打开我的项目文件,并跳转到第50行。” 它会通过pilotty spawn vim yourfile.txt启动vim,然后发送50G的按键指令精准定位。或者,

对AI说:“检查服务器状态,如果负载过高就重启服务。” AI可以通过pilotty运行htop查看负载,并根据结果发送systemctl restart的命令。

介绍

pilotty 解决了AI智能体无法直接与终端用户界面(TUI)交互的核心难题。它通过管理伪终端会话,提供完整的VT100终端模拟,使AI能够“看到”终端屏幕状态,并通过发送键盘、鼠标指令来“操作”像vim、htop、lazygit这样的TUI应用,就像人类用户一样。

使用起来非常简单。通过命令行,你可以让AI智能体启动一个TUI程序,获取其屏幕快照,然后发送按键或点击指令进行交互。例如,你可以让AI智能体自动在vim中编辑文件,或在lazygit中执行版本控制操作。其守护进程模式支持多会话管理,并能自动清理空闲资源。

这个工具特别适合智能体开发者、运维工程师以及任何需要将终端操作自动化集成到AI工作流中的开发者。它为AI赋予了操控复杂命令行工具的能力,打开了自动化运维、自动化测试、交互式代码开发等场景的大门。

需要注意的是,pilotty目前不支持Windows平台,且主要面向程序化调用。虽然它经过了广泛测试,但在生产环境中使用仍需谨慎,建议结合具体场景进行充分验证。

核心特点

pilotty是终端领域的“agent-browser”,专为AI智能体与TUI应用交互设计,提供精准的VT100终端模拟和屏幕状态捕获,而同类工具(如expect脚本)更偏向于预定义流程的自动化,缺乏对AI友好的状态反馈和交互接口。

注意事项

不支持Windows平台,且主要适用于需要程序化控制TUI应用的场景,不适合简单的命令行脚本自动化。

常见问题

pilotty和expect脚本有什么区别?

pilotty专为AI智能体设计,提供实时屏幕状态(JSON格式)和AI友好的错误建议,支持多会话和复杂交互;expect是基于预定义模式匹配的自动化脚本,灵活性较低。

它能控制哪些终端应用?

理论上任何基于终端的TUI应用都可以,如vim, htop, lazygit, dialog, ncdu等,只要它们运行在VT100兼容的终端环境中。

给 AI 助手的安装指引

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

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