pproenca/agent-tui
skills/agent-tui/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add pproenca/agent-tui agent-tuiInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 28, 2026, 6:09 AM67.9s15 files scanned
SKILL.md
- name:
- agent-tui
- description:
- >
agent-tui
Quick start
- Verify install:
agent-tui --version - Install with
npm i -g agent-tui(orpnpm add -g agent-tui,bun add -g agent-tui). - Alternate install:
curl -fsSL https://raw.githubusercontent.com/pproenca/agent-tui/master/install.sh -o /tmp/agent-tui-install.sh && sh /tmp/agent-tui-install.shorcargo install --git https://github.com/pproenca/agent-tui.git --path cli/crates/agent-tui. - If you used the install script, ensure
~/.local/binis on your PATH. - Start a session:
agent-tui run --format json <command> -- <args...> - Observe:
agent-tui screenshot --format json - Act:
agent-tui press Enteroragent-tui type "text" - Wait or verify:
agent-tui wait "Expected text" --assertoragent-tui wait --stable - Cleanup:
agent-tui kill
Core workflow
- Run the app with
agent-tui runand capturesession_idfrom JSON output. - Take a fresh snapshot with
agent-tui screenshotoragent-tui screenshot --format json. - Decide the next action based on the latest snapshot.
- Act with
pressortype. - Synchronize with
wait --assertorwait --stable. - Repeat from step 2 until the task finishes.
- Clean up with
agent-tui kill.
Reliability rules
- Re-snapshot after every action that could change the UI.
- Never act on a changing screen; wait for stability first.
- Verify outcomes with
wait --assertinstead of assuming success. - Always end runs with
killorsessions cleanup.
Session handling
- Use
--session <id>for every command if more than one session exists. - If you lose the session id, run
agent-tui sessionsandagent-tui sessions show <id>.
Live preview (optional)
- Ask whether a live preview is desired.
- Start preview:
agent-tui live start --open - Stop preview when done:
agent-tui live stop
Deep-dive references
- Full CLI coverage and options:
references/command-atlas.md - JSON output contract:
references/output-contract.md - End-to-end command sequences:
references/flows.md - Quick command selection:
references/decision-tree.md - Session lifecycle and concurrency:
references/session-lifecycle.md - Assertions and test oracles:
references/assertions.md - Failure recovery playbook:
references/recovery.md - Safety and confirmation prompts:
references/safety.md - Clarification checklist:
references/clarifications.md - Test plan template:
references/test-plan.md - Demo script:
references/demo.md - User prompt templates:
references/prompt-templates.md - Minimal command sets by use case:
references/use-cases.md - Explorer/replay automation skill:
../tui-explorer/SKILL.md
Related Skills
pproenca/tui-explorer
tools
VerifiedTrustedCommunity
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.
95SKILL.mdUpdated May 28, 2026
openclaw/taskflow
tools
VerifiedTrustedCommunity
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
357,764SKILL.mdUpdated Apr 10, 2026
openclaw/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,764SKILL.mdUpdated Apr 10, 2026
steipete/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,588SKILL.mdUpdated Apr 13, 2026