tui-explorer

Discover and replay terminal UI paths using agent-tui. Use when you need to launch a TUI app, explore navigation with bounded BFS, generate markdown acceptance tests, and verify those tests repeatedly. Do not use for web or desktop GUI automation.

Jump to install

Repository: pproenca/agent-tui
Last source activity: February 18, 2026 at 17:12
Detected SKILL.md language: English
Stars: 113
Forks: 12

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/pproenca/agent-tui --skill tui-explorer

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

6 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

agent-tui

Automate terminal UI (TUI) apps with agent-tui for testing, inspection, demos, and scripted interactions. Use when automating CLI/TUI flows, regression testing terminal apps, verifying interactive behavior, or extracting structured text from terminal UIs. Also use when asked what agent-tui is, how it works, or to demo it. Do not use for web browsers, GUI apps, or non-terminal interfaces.

2026-07-08

View all from this repository

name	tui-explorer
description	Discover and replay terminal UI paths using agent-tui. Use when you need to launch a TUI app, explore navigation with bounded BFS, generate markdown acceptance tests, and verify those tests repeatedly. Do not use for web or desktop GUI automation.

tui-explorer

Purpose

Generate replayable acceptance tests from discovered TUI navigation paths.

Commands

Discover:
- skills/tui-explorer/scripts/tui_explorer discover --command "<app command>"
Verify:
- skills/tui-explorer/scripts/tui_explorer verify --spec "<path-to-acceptance.md>"

Defaults

Exploration strategy: bounded BFS.
Safe action set: Enter, Tab, ArrowDown, ArrowUp, ArrowRight, ArrowLeft, Esc, Space.
Risky actions are disabled unless --allow-risky is set.
Output directory defaults to .agent-tui/discover/<timestamp>/.
Replay fails on scenario failure and exits non-zero.

Workflow

Start live preview over the HTTP endpoint with agent-tui live start --open before discovery so the user can watch exploration in the built-in web UI.
Run discover for the target command.
Inspect generated artifacts:
- acceptance.md (human-readable OpenSpec-style expectations + machine-executable steps)
- trace.jsonl
- discover-report.json
Run verify against the generated acceptance.md.
Stop live preview with agent-tui live stop after verification.

Session handling for live preview:

Treat browser session selection as preview-local context only.
Do not use browser interactions to switch the daemon active session.

On failure, inspect verify-report.json and files under failures/.

References

Schema details: references/schema-v1.md
Discovery mechanics: references/discovery.md
Replay semantics: references/replay.md

tui-explorer

Source facts

Install options

Review the source files

More from this repository

More from this repository

tui-explorer

Purpose

Commands

Defaults

Workflow

References

tui-explorer

Purpose

Commands

Defaults

Workflow

References