SuperAPI AI 工具集

ghostty-terminal-automation

部署与运维

查看项目

更新于 10-15 22:15

技能介绍

用途:通过 MCP 服务器以编程方式自动化 Ghostty 终端会话,基于 ghostty-automator 库,提供类似 Playwright 的操作体验。

主要能力:list_terminals 列出所有终端表面,返回 ID、标题、尺寸、焦点与工作目录。terminal 是包含 18 个动作的超级工具,需提供 terminal_id 与 action。输入类动作:send 发送命令并回车、type 仅输入文本不回车、key 按键组合(按键名遵循 W3C 标准,如 Enter、Tab、Escape、ArrowUp、KeyA、Digit0、F1-F12)。鼠标类:click、double_click、drag、scroll。屏幕类:read 读取文本与光标位置、cells 获取带颜色样式的单元格数据、screenshot 截图。等待类:wait_text 等待文本或正则、wait_prompt 等待 shell 提示符、wait_idle 等待屏幕稳定。断言类:expect 断言文本存在、expect_not 断言文本不存在。管理类:focus、close、resize。new_terminal 可新建窗口或标签页。

必要用法:核心工作流为先 list_terminals 获取 terminal_id,再用 action="read" 查看当前状态,action="send" 发送命令,action="wait_text" 或 action="wait_prompt" 等待完成,最后再次读取或截图验证。也可通过 Python 客户端脚本化:from ghostty_automator import Ghostty,异步用 async with Ghostty.connect() as ghostty,同步用 from ghostty_automator.sync_api import Ghostty。

适用场景:自动化执行终端命令、运行测试并等待结果、操作 TUI 应用(如 Neovim、htop/btop)、通过 cells 检查 TUI 渲染、截图验证复杂操作。

限制:所有交互依赖 Ghostty 终端环境;资料未提供安装步骤、系统平台要求、收费或许可信息。