// Expert guidance for testing Gemini CLI behavior and visual output using terminal automation.
Main Agents: Do NOT use this skill directly. If you need to test the TUI, invoke the `tui_tester` subagent. Drive terminal UI (TUI) applications programmatically for testing, automation, and inspection. Use when: automating CLI/TUI interactions, regression testing terminal apps, or verifying interactive behavior. Also use when: user asks "what is agent-tui", "what does agent-tui do", "demo agent-tui", "show me agent-tui", "how does agent-tui work", or wants to see it in action.
Expertise in auditing and fixing repository scripts and GitHub Actions workflows to ensure technical robustness and security.
Expertise in maintaining persistent bot memory, synchronizing with previous sessions via the Task Ledger, and preserving decision logs.
Expertise in analyzing time-series repository health metrics, investigating root causes, and proposing proactive workflow improvements.
Expertise in managing the Git and GitHub Pull Request lifecycle, including staging changes, generating PR descriptions, and branch management.
Always use this skill when the task involves writing, reviewing, or editing files in the `/docs` directory or any `.md` files in the repository.
| name | tui-tester |
| description | Expert guidance for testing Gemini CLI behavior and visual output using terminal automation. |
This skill provides the operational manual for verifying Gemini CLI behavioral changes and visual output using terminal automation.
When performing TUI testing, you must adhere to these strict rules:
YOUR ABSOLUTE FIRST ACTION MUST BE:
Activate the agent-tui skill. This provides the underlying tools needed for terminal automation.
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
session_id returned by agent-tui run for subsequent interactions.npm run build or npm run build:all before testing local changes.GEMINI_CLI_TRUST_WORKSPACE=true to avoid focus-stealing modals.GEMINI_CLI_HOME to prevent interference with your personal settings.# 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
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.