tui-tester

スター106,204

フォーク14,321

更新日2026年5月18日 15:46

Expert guidance for testing Gemini CLI behavior and visual output using terminal automation.

インストール

Codex または Claude でインストールこの Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。

ソース

google-gemini

google-gemini/gemini-cli

GitHub リポジトリを開く Creator のリポジトリを見る

ダウンロード

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:

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_id 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 GEMINI_CLI_TRUST_WORKSPACE=true to avoid focus-stealing modals.
Isolate Config: Use GEMINI_CLI_HOME to 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.

このリポジトリの他の Skills

同じリポジトリ

effort

google-gemini/gemini-cli

Estimates the implementation effort required to address the given issue.

2026-07-07106.2k

quality

google-gemini/gemini-cli

Evaluates whether a GitHub issue is spam, empty, needs more information, or is OK to proceed.

2026-07-07106.2k

spec-generator

google-gemini/gemini-cli

Generates a structured Workable Spec JSON to guide a Developer Worker.

2026-07-07106.2k

antigravity-support

google-gemini/gemini-cli

Use when the user asks questions, seeks help, or requests instructions related to installing, setting up, or migrating to Antigravity CLI. This skill provides the latest up to date details, requirements, and commands sourced from the official Antigravity CLI documentation.

2026-06-09106.2k

agent-tui

google-gemini/gemini-cli

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.

2026-05-18106.2k

critique

google-gemini/gemini-cli

Expertise in auditing and fixing repository scripts and GitHub Actions workflows to ensure technical robustness and security.

2026-05-12106.2k

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:

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_id 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 GEMINI_CLI_TRUST_WORKSPACE=true to avoid focus-stealing modals.

Isolate Config: Use GEMINI_CLI_HOME to 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.

name	tui-tester
description	Expert guidance for testing Gemini CLI behavior and visual output using terminal automation.