tmux

Automate tmux keystroke injection and scrape pane output for interactive terminals.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Polealpha/XINNIAN_PI --skill tmux-polealpha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/Polealpha/XINNIAN_PI/tree/main/app%20windows/vendor/openclaw-runtime/skills/tmux
Command: npx skills add https://github.com/Polealpha/XINNIAN_PI --skill tmux-polealpha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It solves the problem of needing to remotely drive interactive terminal programs (REPLs and TUI apps) while still reliably reading their live output.

Core Features & Use Cases

  • Isolated tmux socket workflow: Creates and uses a dedicated tmux server via a filesystem socket so multiple runs don’t interfere with each other.
  • Keystroke automation for interactive CLIs: Sends commands and control keys to specific panes or targets for deterministic-ish interaction.
  • Pane output monitoring: Captures recent pane history and supports waiting for text patterns so you can confirm progress.
  • Use Case: You want to run multiple coding agents in parallel (e.g., Codex/Claude Code) and stream back their results without manual terminal control.

Quick Start

Use the tmux Skill to start a dedicated isolated tmux session on an OpenClaw socket and then send a Python REPL command into the target pane.

Frequently Asked Questions about tmux

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

FAQPage Schema
How do I send keystrokes to a tmux session for remote terminal automation?

To send keystrokes for remote terminal automation, this Skill injects commands and control keys into specific tmux panes using an isolated socket directory, ensuring deterministic interaction with interactive CLIs without manual input.

Can I run multiple coding agents in parallel using tmux?

Yes, you can run multiple coding agents in parallel using tmux. This Skill orchestrates isolated socket-based sessions and captures pane output, allowing you to stream results from parallel coding-agent workflows.

How do I capture pane output and wait for a specific text pattern in a REPL?

To capture pane output and wait for text patterns, this Skill monitors recent tmux pane history and uses included helper scripts for pattern-wait support, detecting progress or status prompts in your interactive terminal workflows.

What's the best way to isolate tmux runs so parallel sessions don't interfere with each other?

The best way to isolate tmux runs is by using a dedicated filesystem socket. This Skill establishes an isolated socket directory convention, creating a separate tmux server so multiple terminal automation runs do not conflict.

Does this tmux automation approach require any specific pane targeting syntax?

Yes, this tmux automation approach requires safe pane targeting using the session:window.pane syntax. This precise targeting ensures keystrokes and output scraping apply to the correct pane in interactive terminal workflows.

Why do I need an isolated tmux socket for interactive CLI automation?

You need an isolated tmux socket to prevent conflicts during interactive CLI automation. By using a dedicated socket directory, this Skill ensures keystroke injection and output scraping operate independently of other terminal sessions on the host.