tuivision

Spawn, interact with, and capture terminal UI screenshots for visual regression testing.

3|1|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/mistakeknot/Demarch --skill tuivision
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tuivision
Source: https://github.com/mistakeknot/Demarch/tree/main/.gemini/generated-skills/tuivision
Command: npx skills add https://github.com/mistakeknot/Demarch --skill tuivision

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the interaction with and visual testing of terminal-based applications (TUIs), allowing for robust and reliable testing of command-line interfaces.

Core Features & Use Cases

  • TUI Automation: Spawn, control, and capture the state of TUI applications.
  • Visual Testing: Generate screenshots of TUI applications for regression testing.
  • Use Case: Automatically test a TUI application like htop by spawning it, interacting with it (e.g., scrolling), and taking a screenshot to ensure its UI remains consistent across updates.

Quick Start

Use the tuivision skill to spawn the 'htop' TUI application and capture a screenshot.

Frequently Asked Questions about tuivision

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

FAQPage Schema
How do I automate TUI testing for terminal applications?

Automate TUI testing by programmatically spawning terminal applications, sending keystrokes, and capturing terminal state as text or screenshots for deterministic regression testing.

Can I capture screenshots of command-line interfaces for visual regression testing?

Yes, visual regression testing captures screenshots of command-line interfaces, allowing you to compare terminal UI states across updates to ensure consistent application rendering.

What is the best way to interact with terminal user interface apps during automated testing?

The best way to interact with terminal user interface apps during automated testing is by spawning controlled sessions and sending programmatic keystrokes to simulate user input.

Does tuivision support interacting with TUI applications like htop?

Yes, tuivision supports interacting with TUI applications like htop by spawning the process, simulating interactions such as scrolling, and capturing the resulting terminal state.

Can I use Playwright for visual testing of terminal user interfaces?

While Playwright is typically for web visual regression, tuivision applies similar testing principles to terminal user interfaces by capturing deterministic screenshots of TUI sessions.

Are there limitations when capturing terminal state for TUI automation?

TUI automation limitations depend on the terminal's rendering complexity, though capturing deterministic text and screenshot outputs ensures reliable state validation across test runs.