tui-validate

Validate TUI outputs from files, commands, or tmux sessions using semantic and visual checks.

3.1k|286|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill tui-validate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tui-validate
Source: https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/tui-validate
Command: npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill tui-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams ensure terminal UIs render correctly by validating outputs with LLM-based semantics and visual verification.

Core Features & Use Cases

  • Semantic validation of TUI output using LLMs to assess layout and content.
  • Visual verification using freeze for high-fidelity terminal screenshots.
  • Use Case: Validate that a Ralph TUI header and related components render correctly after changes, ensuring iteration counters, time stamps, and mode indicators appear as expected.

Quick Start

Use the tui-validate skill to validate captured terminal output or a live TUI session against predefined criteria.

Frequently Asked Questions about tui-validate

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

FAQPage Schema
How do I validate terminal UI layouts using LLM semantic checks?

You can validate terminal UI layouts by capturing terminal output and applying LLM-based semantic checks to assess content presence and structure. This approach evaluates captured files or live tmux sessions against configurable criteria.

Can I use freeze to capture terminal screenshots for visual verification?

Yes, freeze is supported as an external tool for high-fidelity visual verification of terminal outputs. It captures screenshots that are then evaluated against defined visual criteria.

Does tui-validate work with live tmux sessions?

Yes, tui-validate operates directly on live tmux sessions to evaluate terminal output. It captures the session output and assesses layout and content against predefined validation criteria.

How do I check if specific TUI components like headers and footers render correctly?

You can validate specific TUI components by defining configurable header, footer, and full-layout criteria. The semantic judging mode then evaluates the captured output to ensure components render as expected.

What is the difference between semantic and visual judging modes for TUI validation?

Semantic judging uses LLMs to assess layout and content presence, while visual judging relies on freeze for high-fidelity terminal screenshots. Both modes evaluate output against your defined criteria.

Do I need external tools installed to validate TUI outputs?

Yes, this skill requires external tools such as freeze and tmux to capture and validate terminal outputs. These dependencies are necessary for both visual verification and live session capture.