What problem does it solve?
Provides programmatic control of interactive tmux sessions so you can automate keystroke-driven CLIs, monitor REPLs, and reliably scrape pane output without manual terminal interaction.
Core Features & Use Cases
- Interactive TTY Automation: Send literal keystrokes, control sequences, and control keys to panes for driving REPLs and other interactive programs.
- Output Scraping & Polling: Capture pane history, wait for text patterns, and extract recent output for downstream processing.
- Socket-based Isolation & Session Management: Use an isolated socket directory convention to run private tmux servers and manage multiple parallel agent sessions.
- Helper Scripts: Includes scripts to find sessions across sockets and to poll a pane for a regex or fixed string with timeout handling.
- Use Case: Orchestrate multiple coding agents in parallel, run automated interactive tests, or monitor long-running CLI tasks and collect their output.
Quick Start
Start an isolated tmux socket, create a detached session, send the desired command into the pane, and capture the pane output using the included helper scripts.