Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 16 additions & 5 deletions skills/agent-tty/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,29 @@
---
name: agent-tty
description: 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.
description: "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."
advertise: true
---

`agent-tty` is a terminal and TUI automation CLI that creates inspectable sessions and reviewable artifacts for agents.
`agent-tty` is a terminal and TUI automation CLI that creates inspectable sessions and reviewable artifacts for agents. Every task follows a create, run, wait, capture, destroy loop.

The CLI provides commands for session lifecycle (create, inspect, destroy), input (run, type, paste, send-keys), observation (wait, snapshot), and capture (screenshot, record export). All commands accept `--json` for machine-readable output and `--home <path>` for isolated sessions.

Load the full canonical core skill from the CLI before doing terminal automation:
`agent-tty skills get agent-tty`

```bash
agent-tty skills get agent-tty
```

Discover additional built-in skills with:
`agent-tty skills list`

```bash
agent-tty skills list
```

For structured QA and TUI dogfooding work, load:
`agent-tty skills get dogfood-tui`

```bash
agent-tty skills get dogfood-tui
```

This bootstrap intentionally stays minimal so the CLI remains the source of truth.