tui-viewer

Capture TUI screenshots and analyze colors, text, and layout.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/chadananda/xswarm-tdd-claude --skill tui-viewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tui-viewer
Source: https://github.com/chadananda/xswarm-tdd-claude/tree/main/skills/tui-viewer
Command: npx skills add https://github.com/chadananda/xswarm-tdd-claude --skill tui-viewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes reference (resource) components.

What problem does it solve?

This Skill provides a universal approach to visually verify Terminal UIs by capturing high-fidelity screenshots and analyzing colors, text, and layout to ensure TUIs render correctly across languages and frameworks.

Core Features & Use Cases

  • Visual verification: Capture TUIs with color fidelity and layout preservation, then programmatically analyze colors, text, and spatial relationships.
  • Iterative development & E2E testing: Support fast feedback loops during development and build visual regression test suites that validate themes and responsive behavior.
  • Platform-agnostic tooling: Works with any language/framework that outputs terminal UI and can integrate with VHS or PTY-based workflows.

Quick Start

  1. Install VHS and dependencies.
  2. Create a VHS tape to reach a target screen, run it, and verify the produced SVG/text contents.
  3. Extend with verification scripts to validate colors/text/layout and enforce cleanup patterns.

Frequently Asked Questions about tui-viewer

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

FAQPage Schema
How do I automate visual regression testing for a terminal UI?

Automated visual regression testing for a terminal UI involves capturing high-fidelity screenshots and programmatically analyzing colors, text, and spatial layout to verify correct rendering. This Skill uses VHS for deterministic captures and SVG or text analysis to validate themes and responsive behavior across iterations.

Can I verify TUI layout and colors programmatically across different frameworks?

Yes, you can verify TUI layout and colors programmatically across different frameworks. This Skill provides a platform-agnostic approach that works with any language outputting terminal UI, capturing screenshots and analyzing SVG or text contents to validate visual fidelity and spatial relationships.

How do I use VHS to capture deterministic TUI screenshots for testing?

To use VHS for deterministic TUI screenshots, you create a VHS tape to reach a target screen and run it to produce SVG or text outputs. You then extend the process with verification scripts to validate the captured colors, text, and layout.

How do I prevent dangling background processes when automating TUI captures?

To prevent dangling background processes during TUI capture automation, you must enforce robust cleanup patterns after running VHS tapes and PTY-based workflows. This Skill includes specific cleanup mechanisms to ensure background terminal processes are safely terminated following visual verification.

Does this visual testing approach support validating responsive behavior across multiple TUI sizes?

Yes, this visual testing approach supports validating responsive behavior across multiple TUI sizes. It enables multi-size and multi-theme validation by capturing high-fidelity screenshots and analyzing the rendered layout to ensure TUIs adapt correctly across diverse terminal environments.