用途:agent-tui 用于自动化驱动终端 UI(TUI)应用,适合测试 Gemini CLI 等命令行界面。主代理不应直接使用该技能,需要测试 TUI 时应调用 tui_tester 子代理。
主要能力:启动受控 TUI 会话(run)、截图观察(screenshot,支持 --format json)、输入文本(type)、发送按键(press)、等待与断言(wait "text" --assert、wait --gone、wait --stable)、列出会话(sessions)、实时预览(live start --open)、结束会话(kill)。
使用方式:支持 macOS/Linux,Windows 暂不支持。安装可用 curl -fsSL https://raw.githubusercontent.com/pproenca/agent-tui/master/install.sh | sh,或 npm i -g agent-tui、pnpm add -g agent-tui、bun add -g agent-tui,或从源码 cargo install。核心循环为 run、screenshot、type/press、wait、verify、kill。规则要求原子执行、每次操作后重新截图、不在不稳定 UI 上操作、用断言验证成功、超时先截图诊断、结束前 kill 清理。
macOS 注意:默认后台守护进程可能崩溃并报 Connection refused (os error 61),需用 tmux 手动启动守护进程,示例命令见资料。重连必须使用 session_id 而非 pid。
测试 Gemini CLI:需先 npm run build 或 npm run build:all;设置 GEMINI_CLI_TRUST_WORKSPACE=true 绕过信任弹窗;可用 GEMINI_CLI_HOME 隔离配置;测试增量(如 /agents reload)需先启动 CLI 再写入新文件。
限制:Windows 暂不支持;守护进程崩溃后伪终端销毁,无法重连旧会话;具体功能、收费与平台支持以官方资料为准,暂未提供更多信息。