tui-tester

Automates terminal-based testing of Gemini CLI behavior and visual output.

Updated May 23, 2026
One-click install
npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill tui-tester-kiranimmadi2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tui-tester
Source: https://github.com/kiranimmadi2/promptforge-ai/tree/main/gemini-cli/.gemini/skills/tui-tester
Command: npx skills add https://github.com/kiranimmadi2/promptforge-ai --skill tui-tester-kiranimmadi2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying that code changes to a terminal UI actually produce the correct interactive behavior and visual rendering is tedious and error-prone when done manually. This Skill provides a structured protocol for automating Gemini CLI testing through terminal automation, covering session management, visual validation, and regression checks. ## Core Features & Use Cases - Behavioral Verification: Confirm that code changes produce the expected terminal interactions by driving the CLI with scripted commands and assertions. - Visual Validation: Capture screenshots and assert on rendered output to ensure the TUI displays correctly across terminal sizes and states. - Regression Testing: Automate interactive workflows to catch breaking changes before they ship. - Use Case: After modifying the Gemini CLI's help command, build the project, launch it in an automated terminal session, type "/help", and assert that "Available Commands" appears in the output. ## Quick Start Ask the AI to test your local Gemini CLI changes by launching it with agent-tui, sending a slash command, and verifying the expected output appears on screen.

Frequently Asked Questions about tui-tester

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test Gemini CLI changes in a terminal automatically?

Build the project with npm run build, then launch the CLI through agent-tui run with GEMINI_CLI_TRUST_WORKSPACE=true. Send keystrokes with agent-tui type and press, then assert on expected output using agent-tui wait.

How do I automate TUI testing with agent-tui?

Start the agent-tui daemon in a tmux session, open the live preview, then follow the loop of action, wait, screenshot, and verify. Execute exactly one command per turn and reuse the session_id returned by agent-tui run.

Does agent-tui testing work on macOS with parallel sessions?

Yes, the setup protocol is macOS and parallel-safe. It checks whether the daemon is running, cleans up stale tmux sessions and temp files, then starts a fresh daemon before opening the live preview.

Why does agent-tui show os error 61 during testing?

Error 61 indicates a connection refusal, usually meaning the daemon stopped or is unreachable. Restart it using the tmux-based setup method, which kills stale sessions and starts a clean daemon process.

How do I avoid workspace trust modals when testing Gemini CLI?

Set GEMINI_CLI_TRUST_WORKSPACE=true before launching the CLI to bypass trust prompts that steal focus. Also set GEMINI_CLI_HOME to isolate test configuration from your personal settings.