Write and Verify Playwright Tests
appsmithorg/appsmith
Writes a Playwright end-to-end test from a prompt, runs it against a live Appsmith deployment and retries with fixes up to three times until it passes.
Explores a terminal app's navigation with bounded breadth-first search and turns the discovered paths into replayable acceptance tests.
Install TUI Explorer
$ npx skills add pproenca/agent-tui --skill tui-explorer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install pproenca/agent-tui tui-explorer --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/pproenca/agent-tui.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tui-explorer .claude/skills/tui-explorer && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "tui-explorer" agent skill from https://github.com/pproenca/agent-tui/tree/master/skills/tui-explorer into .claude/skills/tui-explorer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-explorer", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/pproenca/agent-tui/tree/master/skills/tui-explorerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add pproenca/agent-tui --skill tui-explorer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install pproenca/agent-tui tui-explorer --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/agent-tui.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/tui-explorer .agents/skills/tui-explorer && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "tui-explorer" agent skill from https://github.com/pproenca/agent-tui/tree/master/skills/tui-explorer into .agents/skills/tui-explorer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-explorer", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/agent-tui --skill tui-explorer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install pproenca/agent-tui tui-explorer --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/agent-tui.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/tui-explorer .cursor/skills/tui-explorer && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "tui-explorer" agent skill from https://github.com/pproenca/agent-tui/tree/master/skills/tui-explorer into .cursor/skills/tui-explorer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-explorer", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/pproenca/agent-tui.git --path skills/tui-explorer--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add pproenca/agent-tui --skill tui-explorer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install pproenca/agent-tui tui-explorer --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/agent-tui.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/tui-explorer .gemini/skills/tui-explorer && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "tui-explorer" agent skill from https://github.com/pproenca/agent-tui/tree/master/skills/tui-explorer into .gemini/skills/tui-explorer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-explorer", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install pproenca/agent-tui tui-explorerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add pproenca/agent-tui --skill tui-explorer -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/pproenca/agent-tui.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/tui-explorer .github/skills/tui-explorer && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "tui-explorer" agent skill from https://github.com/pproenca/agent-tui/tree/master/skills/tui-explorer into .github/skills/tui-explorer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-explorer", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add pproenca/agent-tui --skill tui-explorer -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install pproenca/agent-tui tui-explorer --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/pproenca/agent-tui.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/tui-explorer .opencode/skills/tui-explorer && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "tui-explorer" agent skill from https://github.com/pproenca/agent-tui/tree/master/skills/tui-explorer into .opencode/skills/tui-explorer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tui-explorer", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
tui-explorer- GitHub stars
- 118
- Token cost
- ~460 tokens
- SKILL.md length
- 166 words
- Files
- 6 (incl. scripts, references)
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- MIT
At a glance
Explores a terminal app's navigation with bounded breadth-first search and turns the discovered paths into replayable acceptance tests.
- Works in 5 steps: Start live preview over the HTTP… → Run discover for the target command. → Inspect generated artifacts → …
- Generating acceptance tests for a terminal user interface
- SKILL.md covers Purpose, Commands, Defaults and Workflow, plus 1 more section
- Mapping which screens a TUI app can reach through keyboard navigation
What it does
tui-explorer discovers navigation paths in a terminal user interface and turns them into replayable acceptance tests. It runs through agent-tui: the discover command launches the target app command and explores with a bounded breadth-first search using a safe key set of Enter, Tab, the arrow keys, Esc and Space, and risky actions stay disabled unless --allow-risky is passed.
Results go to a timestamped folder under .agent-tui/discover/ with acceptance.md, which holds human-readable expectations in an OpenSpec style plus executable steps, along with trace.jsonl and discover-report.json. The verify command replays acceptance.md and exits non-zero when a scenario fails, writing verify-report.json and files under failures/ for inspection. The suggested flow starts live preview with agent-tui live start --open so you can watch exploration in a web UI, and stops it afterward. It is not for web or desktop GUI automation.
When your agent uses it
- Generating acceptance tests for a terminal user interface
- Mapping which screens a TUI app can reach through keyboard navigation
- Replaying generated scenarios repeatedly to catch regressions
- Reviewing a failed replay through its report and failure files
Example prompts
- “Explore the menus of ./bin/inventory-tui and generate acceptance tests for them.”
- “Verify the acceptance.md from the last discovery run and tell me which scenario failed.”
- “Rerun discovery with risky actions allowed for this sandboxed terminal app.”
Requirements
- The agent-tui tool
- The command that launches the terminal app to explore
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Start live preview over the HTTP endpoint with agent-tui live start --open before discovery so the user can watch exploration in the…
- Run discover for the target command.
- Inspect generated artifacts
- Run verify against the generated acceptance.md.
- Stop live preview with agent-tui live stop after verification.
What it can do on your machine
Read from SKILL.md and the folder at commit 8bf76c4. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/, which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
TUI Explorer loads about 460 tokens when it runs, and up to ~1k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 166 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from pproenca/agent-tui at commit 8bf76c4, republished under its MIT licence (© pproenca). 166 words, ~460 tokens.
Download SKILL.mdSave it as
.claude/skills/tui-explorer/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.- 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-riskyis 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 --openbefore discovery so the user can watch exploration in the built-in web UI. - Run
discoverfor the target command. - Inspect generated artifacts:
acceptance.md(human-readable OpenSpec-style expectations + machine-executable steps)trace.jsonldiscover-report.json
- Run
verifyagainst the generatedacceptance.md. - Stop live preview with
agent-tui live stopafter 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.jsonand files underfailures/.
References
- Schema details:
references/schema-v1.md - Discovery mechanics:
references/discovery.md - Replay semantics:
references/replay.md
© pproenca, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 5 other files (scripts, references) in skills/tui-explorer of pproenca/agent-tui.
- SKILL.md
- agents/openai.yaml
- references/discovery.md
- references/replay.md
- references/schema-v1.md
- scripts/tui_explorer
Open the folder on GitHubat commit 8bf76c4
Compare with similar skills
TUI Explorer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| TUI Explorer this skillpproenca/agent-tui | 118 | — | ~460 | Automated safety check: Pass | MIT | |
| Write and Verify Playwright Testsappsmithorg/appsmith | 41k | — | ~2.9k | Automated safety check: Notes | Apache-2.0 | |
| Engine E2Ewix/react-native-navigation | 13k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Senior QAnicepkg/auto-company | 192 | 3 repos | ~1.1k | Automated safety check: Notes | None | |
| Explore Feature E2E Testcomet-ml/opik | 22k | — | ~3.4k | Automated safety check: Pass | Apache-2.0 | |
| Kane CLI Browser TestingLambdaTest/kane-cli | 247 | — | ~8.4k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
Engine E2E
wix/react-native-navigation
Run Wix Engine (mobile-apps-engine) iOS E2E tests locally to validate RNN changes.
Senior QA
nicepkg/auto-company
Comprehensive QA and testing skill for quality assurance, test automation, and testing strategies for ReactJS, NextJS, NodeJS applications.
Explore Feature E2E Test
comet-ml/opik
Turns a code change into one committed, passing Playwright end-to-end spec by resolving the change scope and handing authoring to a companion skill.
Kane CLI Browser Testing
LambdaTest/kane-cli
Drives a real browser through the kane-cli tool and designs requirement-linked test suites from a PRD or a plain description, with mobile and cloud-grid runs.
- Official
Run E2E Test
kubernetes-sigs/cloud-provider-azure
Parse a Go e2e test from tests/e2e/, translate each step to kubectl and az CLI commands, and interactively replay the test against a live cluster.
More from pproenca/agent-tui
Terminal UI Automation
pproenca/agent-tui
Drives terminal UI apps from the command line for testing, demos and scripted interactions, using a run, screenshot, act, wait loop.
Related
Categories
Questions about TUI Explorer
What does TUI Explorer do?
Explores a terminal app's navigation with bounded breadth-first search and turns the discovered paths into replayable acceptance tests. tui-explorer discovers navigation paths in a terminal user interface and turns them into replayable acceptance tests. It runs through agent-tui: the discover command launches the target app command and explores with a bounded breadth-first search using a safe key set of Enter, Tab, the arrow keys, Esc and Space, and risky actions stay disabled unless --allow-risky is passed.
When should I use TUI Explorer?
TUI Explorer fits situations like: generating acceptance tests for a terminal user interface; mapping which screens a TUI app can reach through keyboard navigation; replaying generated scenarios repeatedly to catch regressions; reviewing a failed replay through its report and failure files.
How do I install TUI Explorer in Claude Code?
Run `npx skills add pproenca/agent-tui --skill tui-explorer -a claude-code`. Or copy the skill folder (skills/tui-explorer in pproenca/agent-tui) into .claude/skills/tui-explorer in your project. Claude Code loads it when a task matches its description.
How do I install TUI Explorer in Codex?
Run `npx skills add pproenca/agent-tui --skill tui-explorer -a codex`. Or copy the skill folder (skills/tui-explorer in pproenca/agent-tui) into .agents/skills/tui-explorer in your project. Codex loads it when a task matches its description.
Can I use TUI Explorer in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pproenca/agent-tui --skill tui-explorer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tui-explorer, .gemini/skills/tui-explorer, .github/skills/tui-explorer and .opencode/skills/tui-explorer in your project.
What does TUI Explorer need to run?
SKILL.md names no scripts, command-line tools or credentials: TUI Explorer is instructions for the agent only. Our summary lists: The agent-tui tool; The command that launches the terminal app to explore.
Does TUI Explorer access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is TUI Explorer safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does TUI Explorer use?
TUI Explorer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does TUI Explorer use?
About 460 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 559 tokens, read only when the agent opens those files.
What are the alternatives to TUI Explorer?
Skills that share tags, products or a category with TUI Explorer: Write and Verify Playwright Tests (appsmithorg/appsmith, 41k stars), Engine E2E (wix/react-native-navigation, 13k stars), Senior QA (nicepkg/auto-company, 192 stars) and Explore Feature E2E Test (comet-ml/opik, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains TUI Explorer?
pproenca (a GitHub user) maintains it in pproenca/agent-tui, which has 118 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 4, 2026.
Source: pproenca/agent-tui on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.