LABSCO SUMMARY
agent-tui lets your coding assistant drive terminal apps the way a person would. This repository holds the agent-tui program and the skill that teaches your assistant to use it.
The skill walks your assistant through one loop: start the app, read the screen, press keys or type, wait for the screen to settle, and check the result. Use it to test command-line and full-screen terminal programs, record demos, or pull text out of them; it is not for web pages or desktop apps.
The agent-tui program is installed separately, with npm, Homebrew or Rust's cargo. It runs on Linux, macOS and other Unix systems, not natively on Windows.
WHAT'S INSIDE
Lets your assistant drive terminal apps the way a person would: start the app, read the screen, press keys or type, wait for the screen to settle, and check the result. Use it to test command-line and full-screen terminal programs, record demos, or pull text out of them. It works through the agent-tui command-line program, which you install separately.
INSTALL
SINGLE SKILL
Run this outside your AI tool, using Node.js 22.20.0 or newer. Skills CLI 1.7.2 skips skill selection; prompts cancel installation without an interactive terminal. If choosing Project when asked about installation scope, open your project's folder before running this.
Install checklist
Additional agents. ↑/↓ moves, Space toggles selections, Enter confirms.Installing to: for your intended tool. Stop if it names a different tool.Symlink (Recommended) for shared files or Copy to all agents for separate copies; review the summary before confirming installation.Install the find-skills skill? defaults to Yes, adding another skill for all projects. Choose No if you don't want that extra installation.npx skills add pproenca/agent-tui --skill "agent-tui" --full-depth