tui-e2e

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

2|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/lovon-spec/intendant --skill tui-e2e
Or copy as Structured Prompt for Agent
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.