tmux

Drive tmux sessions by sending keystrokes and scraping pane output.

335|2|Updated May 6, 2026
One-click install
npx skills add https://github.com/THU-SAGE/syll --skill tmux-thu-sage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/THU-SAGE/syll/tree/main/syll/skills/tmux
Command: npx skills add https://github.com/THU-SAGE/syll --skill tmux-thu-sage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the challenge of running interactive command-line programs remotely by letting you drive tmux sessions through keystrokes and reliably read pane output.

Core Features & Use Cases

  • Isolated tmux socket sessions: Creates and controls a dedicated tmux server using a configurable socket directory to avoid interfering with existing user sessions.
  • Keystroke-based interaction: Sends commands and control keys (like Ctrl+C) into a specific pane target using send-keys.
  • Output scraping and prompt waiting: Captures recent pane history and can poll for a regex pattern using helper scripts to detect readiness or completion.
  • Parallel agent orchestration: Run multiple coding agents concurrently in separate tmux sessions, then poll and retrieve outputs for each.

Quick Start

Create an isolated tmux socket session, start a shell/REPL inside it, and capture recent output history so an AI or operator can continue interacting with the interactive CLI.

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 using tmux?

Automate interactive CLI workflows using tmux by sending keystrokes to specific panes and scraping pane output. This Skill uses helper scripts for deterministic polling and pattern matching to detect prompt readiness, enabling programmatic continuation of remote REPLs.

Can I run multiple coding agent sessions in parallel with terminal automation?

Run multiple coding agent sessions in parallel by orchestrating separate tmux sessions. This Skill creates an isolated tmux socket directory to prevent interference with existing user sessions, allowing you to poll and retrieve outputs for each concurrent coding agent.

How does pane scraping work for detecting prompt readiness in a REPL?

Pane scraping for prompt detection works by capturing recent pane history and polling for a regex pattern using included helper scripts. This approach waits for specific prompt patterns to appear in the terminal output, signaling that the interactive CLI is ready for the next keystroke.

Do I need an existing tmux server to control sessions remotely?

You do not need an existing tmux server to control sessions remotely. This Skill creates and controls a dedicated tmux server using a configurable isolated socket directory, ensuring that your terminal automation tasks do not interfere with your current interactive user sessions.

What is the best way to send control keys like Ctrl+C to a tmux pane programmatically?

The best way to send control keys like Ctrl+C to a tmux pane programmatically is by using the send-keys command. This Skill enables remote interactive control by sending commands and control keys directly into a specific pane target for driving interactive developer tools.

Why does my terminal automation script interfere with my active tmux sessions?

Terminal automation scripts interfere with active sessions when sharing the default tmux socket. This Skill avoids conflicts by using an isolated tmux socket directory convention, creating a dedicated server so your automated keystroke control and pane scraping remain separate from existing user sessions.