tmux

Send keystrokes to tmux panes and poll terminal output.

6|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/archibate/archibate-skills --skill tmux-archibate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/archibate/archibate-skills/tree/main/skills/tmux
Command: npx skills add https://github.com/archibate/archibate-skills --skill tmux-archibate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, grep, and includes scripts (resource) components.

What problem does it solve?

This Skill automates driving interactive terminal programs by sending keystrokes and scraping pane output so agents and users no longer need to manually operate REPLs, debuggers, or other TTY tools.

Core Features & Use Cases

  • Send literal keystrokes and control keys to targeted tmux panes to run and control interactive programs reliably.
  • Capture and poll pane output to wait for prompts or completion markers using helper scripts, enabling scripted debugging and REPL workflows.
  • Use a private socket convention to isolate agent sessions from user tmux configuration and safely create, list, and clean up sessions.
  • Real-world example: start a Python REPL in a private tmux session, wait for the Python prompt, run test commands, and then collect the output for analysis.

Quick Start

Start an isolated tmux session on a private socket, launch python3 -q in it, and poll the pane until the Python prompt appears so you can send code and capture results.

Frequently Asked Questions about tmux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate interactive CLI workflows and control REPLs with tmux?

You can automate interactive CLI workflows by using tmux to send literal keystrokes to targeted panes and capture terminal output. This allows agents to reliably control REPLs, debuggers, and other TTY applications without manual operation.

What is the best way to run scripted debugging workflows with GDB in an isolated terminal?

Running scripted debugging with GDB is best handled by creating a private tmux session on a dedicated socket. You can send control keys to the pane, poll the output for completion markers, and capture the results for analysis.

Does tmux session management work on macOS for automating TTY applications?

Yes, tmux session management works on both Linux and macOS for automating TTY applications. It requires a local tmux binary and uses helper scripts with sockets placed under a specific directory to isolate agent sessions from user configurations.

Can I scrape terminal output to wait for a Python REPL prompt before sending commands?

Yes, you can scrape terminal output to wait for a Python REPL prompt. The skill captures and polls pane output using helper scripts to detect prompts or completion markers, ensuring you only send code once the interactive session is ready.

How do I start an isolated tmux session to prevent agent automation from affecting my user configuration?

To start an isolated tmux session, you use a private socket convention that separates agent sessions from your personal tmux configuration. Helper scripts manage these sockets to safely create, list, and clean up isolated sessions.

What are the limitations of using tmux pane polling for terminal automation?

A limitation of tmux pane polling is its dependency on detecting prompts or completion markers in the scraped text output. It requires a local tmux binary and relies on specific socket directories, meaning heavily customized terminal prompts may complicate output detection.