tmux

Send keystrokes and capture pane output from tmux sessions.

Updated Sep 1, 2021
One-click install
npx skills add https://github.com/unclehowell/unclehowell --skill tmux-unclehowell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/unclehowell/unclehowell/tree/main/skills/tmux
Command: npx skills add https://github.com/unclehowell/unclehowell --skill tmux-unclehowell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the challenge of managing interactive terminal sessions in non-interactive environments by enabling remote control of tmux panes through keystroke injection and output scraping.

Core Features & Use Cases

  • Session Management: Create, target, and monitor isolated tmux sessions using custom sockets for secure, parallel operations.
  • Input and Output Handling: Send commands or control keys to panes and capture recent history or wait for specific text patterns.
  • Use Case: Orchestrate multiple coding agents in parallel sessions to fix bugs across git worktrees simultaneously, polling for completion prompts without manual intervention.

Quick Start

Create a new tmux session named python-repl and send keys to start an interactive Python shell for remote execution.

Frequently Asked Questions about tmux

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

FAQPage Schema
How do I control interactive terminal sessions remotely in a non-interactive environment?

Control remote tmux sessions by injecting keystrokes and scraping pane output, enabling interactive CLI management in non-interactive environments. This allows you to automate terminal workflows and capture responses programmatically.

Can I orchestrate multiple coding agents in parallel using tmux sessions?

Yes, you can orchestrate multiple coding agents in parallel using isolated tmux sessions. By targeting custom sockets, you can run agents across different git worktrees simultaneously and poll for completion prompts without manual intervention.

How do I capture output and wait for specific text patterns in a tmux pane?

Capture pane output and detect specific text patterns using polling helpers. You can send commands or control keys to a pane and continuously monitor the recent history until your expected text pattern appears in the session.

Does tmux remote control work on macOS and Linux for process monitoring?

Yes, remote tmux control works on both Linux and macOS for non-interactive terminal automation and process monitoring. The only requirement is that the tmux binary is available on your system's PATH.

Do I need any specific dependencies to start scripting remote tmux sessions?

You only need the tmux binary installed on your PATH to start scripting remote session control. No additional dependencies are required, as the Skill uses isolated sockets and built-in polling helpers for session discovery and text detection.