ghostty-automator-python
为终端模拟器Ghostty提供Playwright风格的自动化测试库。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ghostty-automator-python。 它的用途是：为终端模拟器Ghostty提供Playwright风格的自动化测试库。 完整的 Skill 内容见：https://321skill.com/skills/ghostty-automator-python/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我写一个脚本，自动登录服务器，检查服务状态，并截图保存。'，它会利用ghostty-automator生成Python代码，通过连接Ghostty终端，发送SSH登录命令，等待特定状态输出，并自动截取终端屏幕保存为PNG图片，完成自动化巡检。
介绍
ghostty-automator-python 是一个专为现代化终端模拟器Ghostty设计的自动化库。它解决了在终端环境中进行自动化测试、脚本录制和UI交互模拟的难题，让开发者能够像用Playwright控制浏览器一样，通过代码精确控制终端窗口、发送命令、等待特定输出并截图验证。
使用方式非常直观，开发者通过Python API连接到运行中的Ghostty实例，即可获取终端对象进行操作。库提供了异步和同步两种API，支持发送命令、等待文本出现、进行断言以及截图等核心功能，其链式调用风格让自动化脚本的编写清晰流畅。
它非常适合需要进行终端应用测试、构建CLI工具自动化流程或制作终端操作演示的开发者。无论是验证一个命令行工具的交互流程，还是自动化执行一系列复杂的部署命令，这个库都能提供强大的支持。
需要注意的是，该库依赖于一个特定版本的Ghostty分支（ghostty-automator），该分支内置了IPC自动化支持，标准的Ghostty发行版无法使用。因此，在使用前务必按照文档指引安装正确的Ghostty版本。
核心特点
与通用的终端模拟器控制脚本或expect工具相比，它提供了类似Playwright的现代化、强类型、异步优先的API，内置自动等待和丰富的断言功能，将终端自动化提升到了前端自动化测试的工程化水平。
注意事项
必须使用特定的Ghostty分支（ghostty-automator），无法在标准终端或其他终端模拟器上使用。
常见问题
为什么连接Ghostty时提示权限错误？
可能是因为IPC套接字文件权限不安全，可以尝试使用 `Ghostty.connect(validate_socket=False)` 参数跳过验证，或手动修复套接字文件权限。
可以在iTerm2或Windows Terminal上使用吗？
不能，此库是专门为支持自动化协议的Ghostty分支设计的，不兼容其他终端模拟器。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ghostty-automator-python/raw/index.md 读取 ghostty-automator-python 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ghostty-automator-python/raw/index.md（查看排版版本）