How do I install the Tui Explorer skill?

Run npx skillmds@latest add pproenca/tui-explorer in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tui Explorer safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tui Explorer?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tui Explorer free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tui Explorer?

pproenca (@pproenca) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tui Explorer by pproenca — Agent Skill

Name: Tui Explorer
Rating: 4.666666666666667 (3 reviews)
Author: pproenca

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.

pproenca Updated Sep 10, 2026

File contents

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

Frequently asked questions