tui-explorer

Explore terminal UI paths and generate OpenSpec-style markdown tests.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/devinitive-team/mirage --skill tui-explorer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tui-explorer
Source: https://github.com/devinitive-team/mirage/tree/main/.agents/skills/tui-explorer
Command: npx skills add https://github.com/devinitive-team/mirage --skill tui-explorer

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of automating the discovery and replay of terminal UI paths, enabling the creation of testable acceptance tests for terminal applications.

Core Features & Use Cases

  • TUI Navigation Discovery: Automatically explore terminal user interfaces and record paths.
  • Markdown Acceptance Tests: Generate markdown files containing human-readable and executable steps for verification.
  • Replay Verification: Run tests to verify that terminal applications behave as expected.
  • Use Case: Imagine you have a complex command-line tool that requires a precise sequence of actions. Use this Skill to explore the navigation, generate tests, and validate that the tool functions correctly.

Quick Start

Discover navigation paths for a terminal application and generate tests by running: skills/tui-explorer/scripts/tui_explorer discover --command "<app command>"

Frequently Asked Questions about tui-explorer

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

FAQPage Schema
How do I automate terminal UI exploration and generate acceptance tests?

Automate terminal UI exploration by running the discovery script with your application command to record navigation paths and generate OpenSpec-style markdown tests for deterministic replay verification.

What is replay testing for command-line interfaces?

Replay testing for command-line interfaces involves recording terminal UI navigation paths and executing them again to verify that the application maintains deterministic state behavior and functions as expected.

Can I use this to test navigation paths in complex terminal applications?

Yes, you can test complex terminal applications by discovering precise sequences of actions, generating human-readable markdown acceptance tests, and running replay verification to validate behavior.

How do I generate markdown test files from terminal application paths?

Generate markdown test files by executing the discover script with your target application command, which automatically records UI paths and outputs OpenSpec-style markdown containing executable verification steps.

Do I need any external dependencies to perform terminal UI replay testing?

No external dependencies are required to perform terminal UI replay testing, as the Skill operates independently using its internal scripts and references to discover paths and generate tests.