让 AI 编程真正”看得见”——agent-terminal 把终端截图塞进 PR ！

做过 AI 编程的兄弟都知道，现在 Agent 输出代码能力已经挺强了——但它执行结果你看得见吗？大部分时候，Agent 跑完命令扔回一屏幕文本日志，你看还是得自己再跑一遍验证。

agent-terminal 这个 Skill 就是来解决这个问题的。

它是什么

简单说，这是一个给 AI Agent 用的终端自动化 CLI。它让 AI 能够：创建隔离的终端会话、运行任意命令（交互式 TUI 也行）、读取屏幕快照、截屏、甚至录屏导出。

打个比方：Playwright 是用来自动化浏览器的，agent-terminal 就是用来自动化终端/TUI 应用的。

核心能力

交互式终端：Agent 不再只能跑个 ls 或 git pull —— 它能真正驱动 nvim、htop、mysql 这种交互式 TUI，还能发送按键、粘贴多行内容、等待屏幕出现指定字符。

截图/录屏留证：Agent 干完活，不只甩给你一行文字结果——它直接把终端截图或 WebM 录屏附到 PR 里。你点开就能看到 nvim 界面到底长什么样，比看日志直观一万倍。

隔离环境：每个任务在独立的临时目录里跑，不污染主系统，完美适合 CI 场景。

完整工作流：

# 创建隔离会话
SESSION_ID=$(agent-terminal create --json -- /bin/bash)

# 让 Agent 跑命令
agent-terminal run "$SESSION_ID" 'nvim --clean'

# 等待界面出现
agent-terminal wait "$SESSION_ID" --text 'nvim' --json

# 截图留证
agent-terminal screenshot "$SESSION_ID"

# 销毁会话
agent-terminal destroy "$SESSION_ID"

解决什么问题

AI 调试 TUI 更高效：以前 Agent 修一个 nvim 配置，得靠你帮它跑一遍看结果。现在它自己截图回来确认修对了，再提交。

PR review 更轻松：截图/录屏直接进 PR description，reviewer 秒懂 Agent 做了什么，不用自己复现。

TUI bug 重现：报告说 htop 界面在某个场景下乱跳？让 Agent 起一个干净终端复现问题，录屏给你看。

怎么装

npm install -g agent-terminal

SkillsMP 上搜 agent-terminal，用 npx skills add https://github.com/coder/agent-tty --skill agent-terminal 直接装进 Claude Code 或 Codex。

GitHub

https://github.com/coder/agent-tty

一句话：给 AI Agent 一双”眼睛”看终端，它干活你放心。

GitHub: https://github.com/coder/agent-tty