What problem does it solve?
Enable automated control of interactive TTY programs by sending keystrokes and scraping pane output so agents or automation can interact with programs that require a real terminal.
Core Features & Use Cases
- Remote session orchestration: Create and manage isolated tmux sockets and sessions to run multiple interactive agents in parallel.
- Input emulation and monitoring: Safely send literal keystrokes or control keys to targeted panes and capture recent pane history for programmatic inspection.
- Helper tooling: Includes scripts to find sessions across sockets and to poll a pane for a regex or fixed string, useful for detecting prompts or completion.
- Use case: Run several coding agents across separate worktrees, send commands to each agent's REPL, wait for prompt markers, and then capture their output for aggregation.
Quick Start
Start or attach to a tmux socket, send keys to the target pane, and capture its recent output for inspection.