Tui Tester Agent Skill
Expert guidance for testing Gemini CLI behavior and visual output using terminal automation.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/google-gemini/gemini-cli --skill tui-testerThe instruction itself
9 sections, as written by the authorTUI 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:
if ! agent-tui sessions >/dev/null 2>&1; then
tmux kill-session -t agent-tui 2>/dev/null || true
agent-tui daemon stop 2>/dev/null || true
rm -f /tmp/agent-tui*
tmux new-session -d -s agent-tui 'agent-tui daemon start --foreground > /tmp/agent-tui-daemon.log 2>&1'
sleep 1
fi
agent-tui live start --open
3. Session Management
- Session IDs: Always use the
session_idreturned byagent-tui runfor 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 buildornpm run build:allbefore testing local changes. - Bypass Trust: Set
GEMINI_CLI_TRUST_WORKSPACE=trueto avoid focus-stealing modals. - Isolate Config: Use
GEMINI_CLI_HOMEto prevent interference with your personal settings.
Workflow Example
# Start the CLI
env GEMINI_CLI_TRUST_WORKSPACE=true agent-tui run node packages/cli/dist/index.js
# Wait for the prompt
agent-tui wait "│" --assert
# Send a command
agent-tui type "/help"
agent-tui press Enter
# Verify output
agent-tui wait "Available Commands" --assert
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.
Other skills for the same job
different authors, same section of the catalogue
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup
Use when implementing any feature or bugfix, before writing implementation code
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always
Expert guidance for systematic backtesting of trading strategies. Use when developing, testing, stress-testing, or validating quantitative trading strategies. Covers "beating ideas to death" methodology, parameter robustness testing, slippage modeling, bias prevention, and interpreting backtest results. Applicable when user asks about backtesting, strategy validation, robustness testing, avoiding overfitting, or systematic trading development.
Cloud laboratory platform for automated protein testing and validation. Use when designing proteins and needing experimental validation including binding assays, expression testing, thermostability measurements, enzyme activity assays, or protein sequence optimization. Also use for submitting experiments via API, tracking experiment status, downloading results, optimizing protein sequences for better expression using computational tools (NetSolP, SoluProt, SolubleMPNN, ESM), or managing protein design workflows with wet-lab validation.
This skill should be used for time series machine learning tasks including classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search. Use when working with temporal data, sequential patterns, or time-indexed observations requiring specialized algorithms beyond standard ML approaches. Particularly suited for univariate and multivariate time series analysis with scikit-learn compatible APIs.
How to use it
Take google-gemini/tui-tester from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.