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.
agent-tui --versionnpm i -g agent-tui (or pnpm add -g agent-tui, bun add -g agent-tui).curl -fsSL https://raw.githubusercontent.com/pproenca/agent-tui/master/install.sh -o /tmp/agent-tui-install.sh && sh /tmp/agent-tui-install.sh or cargo install --git https://github.com/pproenca/agent-tui.git --path cli/crates/agent-tui.~/.local/bin is on your PATH.agent-tui run --format json <command> -- <args...>agent-tui screenshot --format jsonagent-tui press Enter or agent-tui type "text"agent-tui wait "Expected text" --assert or agent-tui wait --stableagent-tui killagent-tui run and capture session_id from JSON output.agent-tui screenshot or agent-tui screenshot --format json.press or type.wait --assert or wait --stable.agent-tui kill.wait --assert instead of assuming success.kill or sessions cleanup.--session <id> for every command if more than one session exists.agent-tui sessions and agent-tui sessions show <id>.agent-tui live start --openagent-tui live stopreferences/command-atlas.mdreferences/output-contract.mdreferences/flows.mdreferences/decision-tree.mdreferences/session-lifecycle.mdreferences/assertions.mdreferences/recovery.mdreferences/safety.mdreferences/clarifications.mdreferences/test-plan.mdreferences/demo.mdreferences/prompt-templates.mdreferences/use-cases.md../tui-explorer/SKILL.md