shell-use

shell-use controls a real terminal from the command line. It runs shells and TUI programs in a headless PTY behind a background daemon: a stateless CLI front end talks to a daemon that owns the PTY and renders it into a full terminal emulator. Each call connects, acts, and exits, and they all share one live session. With it you can spawn a session, read the rendered screen, send keys and mouse input, wait for a condition, assert on the result, and record the session.

Built for agents: self-documenting commands

Three commands let an agent look up the rest of the surface instead of guessing:

• shell-use agent-context: versioned JSON describing every command, flag, enum, default, and the exit-code taxonomy. It is generated from the CLI, so it stays in sync. Read this first when you need exact argument shapes.
• shell-use usage: a one-screen command cheatsheet.
• shell-use skill: this guide.