tui-e2e

Name: tui-e2e
Availability: InStock
Author: lovon-spec

Automate end-to-end TUI testing in headless environments via Xvfb and a JSON control socket.

2|Updated Mar 2, 2026

Search Tags:#automation #testing #e2e #tui #socket #xvfb #intendant

Ready to run

npx skills add https://github.com/lovon-spec/intendant --skill tui-e2e

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tui-e2e
Source: https://github.com/lovon-spec/intendant/tree/main/tests/skills/tui-e2e
Command: npx skills add https://github.com/lovon-spec/intendant --skill tui-e2e

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end testing of the Intendant TUI within a headless display environment, enabling reliable validation by starting a virtual display, launching the TUI in a controlled window, and verifying behavior via a JSON control socket.

Core Features & Use Cases

E2E harness for Intendant's TUI across headless environments
Uses Xvfb to provide a virtual display and x11vnc for human visibility
Interacts with the TUI through a control socket JSON protocol for deterministic verification
Ideal for regression tests and nightly validation of UI behavior

Quick Start

Install prerequisites and run the test suite to execute the TUI end-to-end tests.

Frequently Asked Questions about tui-e2e

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

FAQPage Schema

How do I automate TUI end-to-end tests in a headless environment?▼

To automate TUI end-to-end tests in a headless environment, launch Xvfb to create a virtual display, run the TUI inside xterm, and verify behavior deterministically through a JSON control socket.

What is the best way to validate TUI behavior across different environments?▼

Validating TUI behavior across environments is best achieved by running the application within a virtual display using Xvfb and asserting its outputs via a Bash-based control protocol for deterministic checks.

Do I need Xvfb and x11vnc to run headless TUI tests?▼

Yes, you need Xvfb to provide the virtual display and x11vnc for human visibility, alongside xterm and socat, to establish the controlled window and socket required for reliable headless TUI validation.

Can I use a JSON control socket for deterministic TUI verification?▼

Yes, you can use a JSON control socket for deterministic TUI verification by interacting with the application through a Bash-based control protocol that asserts behavior reliably during regression and nightly validation.

Why use a virtual display for terminal UI regression testing?▼

Using a virtual display for terminal UI regression testing ensures reliable validation by launching the TUI in a controlled headless window, preventing environment-specific rendering issues from causing flaky test results.