agent-terminallisted

Terminal and TUI automation CLI for AI agents. Use when the user needs to create a terminal session, run a command in a terminal, automate an interactive CLI or TUI, wait for terminal output, capture a TUI screenshot, export a terminal recording, or test a CLI workflow with reviewable artifacts.
coder/agent-tty · ★ 4 · AI & Automation · score 73

Install: claude install-skill coder/agent-tty

# Terminal Automation with agent-terminal Install the CLI with `npm install -g agent-terminal`, then use `agent-terminal` directly. Prefer isolated homes, JSON envelopes, and renderer-backed artifacts so terminal workflows stay reviewable and reproducible. ## Core Workflow Every terminal or TUI automation task should follow this pattern: 1. **Create an isolated home** with `--home`. 2. **Check prerequisites** with `doctor --json` before screenshot or recording work. 3. **Create a session** with `create --json`. 4. **Run setup commands** with `run` instead of simulating long shell typing. 5. **Wait on observable terminal state** with `wait` instead of blind sleeps. 6. **Inspect the current screen** with `snapshot`. 7. **Capture proof artifacts** with `screenshot` or `record export`. 8. **Destroy the session** when finished. ```bash AGENT_HOME="$(mktemp -d)" agent-terminal --home "$AGENT_HOME" doctor --json SESSION_ID=$(agent-terminal --home "$AGENT_HOME" create --json -- /bin/bash | jq -r '.result.sessionId') agent-terminal --home "$AGENT_HOME" run "$SESSION_ID" 'printf "ready\n"' agent-terminal --home "$AGENT_HOME" wait "$SESSION_ID" --text 'ready' --json agent-terminal --home "$AGENT_HOME" snapshot "$SESSION_ID" --format text --json agent-terminal --home "$AGENT_HOME" screenshot "$SESSION_ID" --json agent-terminal --home "$AGENT_HOME" record export "$SESSION_ID" --format webm --json agent-terminal --home "$AGENT_HOME" destroy "$SESSION_ID" --json ``` ## Essential Comma