Agent skill · operations · google-gemini
tui-tester
Expert guidance for testing Gemini CLI behavior and visual output using terminal automation.
Why this skill is useful
Adds specific terminal automation commands and workflows for testing Gemini CLI that the AI wouldn't reliably generate on its own.
What it needs
Requires agent-tui installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 106,400 stars on the source repository.
What this skill does
TUI Tester Skill This skill provides the operational manual for verifying Gemini CLI behavioral changes and visual output using terminal automation. Core Responsibilities Verify Behavior: Confirm that code changes result in the expected terminal interactions. Visual Validation: Ensure the TUI renders correctly across different terminal sizes and states. Regression Testing: Use automation to prevent breaking existing interactive workflows. Critical Protocol When performing TUI testing, you must adhere to these strict rules: 1. Initialization YOUR ABSOLUTE FIRST ACTION MUST BE: Activate the agent-tui skill. This provides the underlying tools needed for terminal automation. 2. Environment Setup (macOS / Parallel Safe) Ensure the global daemon is running and the live preview is open: 3. Session Management Session IDs: Always use the sessionid returned by agent-tui run for subsequent interactions. Atomic Execution: Execute exactly one command per turn. Do not pipeline actions. The Loop: Action -> Wait -> Screenshot -> Verify -> Next Action. 4. Gemini CLI Specifics Build First: Always run npm run build or npm run build:all before testing local changes. Bypass Trust: Set GEMINICLITRUSTWORKSPACE=true to avoid focus-stealing modals. Isolate Config: Use GEMINICLIHOME to prevent interference with your personal settings. Workflow Example Error Recovery If a wait times out, take a fresh screenshot to diagnose the state. If you see os error 61, restart the daemon using the tmux method.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills google-gemini/tui-tester