tmux

Remote-control tmux sessions by sending keystrokes and scraping pane output.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/qiushido/picoclaw-lite --skill tmux-qiushido
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/qiushido/picoclaw-lite/tree/main/workspace/skills/tmux
Command: npx skills add https://github.com/qiushido/picoclaw-lite --skill tmux-qiushido

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Interactive command-line programs like REPLs, debuggers, and coding agents require a real TTY, which makes them hard to drive from automated scripts. This Skill lets you spawn, control, and monitor those interactive sessions through tmux without manual terminal work. ## Core Features & Use Cases - Session Management: Create isolated tmux sessions on private sockets, list running sessions, and clean them up when finished. - Input and Output Control: Send literal keystrokes or control keys to panes and capture scrollback history to read program output. - Output Waiting: Poll a pane for a regex or fixed string with a configurable timeout using the wait-for-text helper script. - Use Case: Launch five parallel coding agents (e.g., Codex) in separate tmux sessions, poll each pane for the shell prompt to detect completion, then capture the full output of finished sessions. ## Quick Start Start a detached tmux session on an isolated socket, send a command to it, and capture the pane output to see the result.

Frequently Asked Questions about tmux

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

FAQPage Schema
How do I send commands to a tmux session from a script?

Use tmux send-keys with the -l flag for literal text, followed by Enter as a separate key. Target the pane with the session:window.pane format, for example tmux -S "$SOCKET" send-keys -t session:0.0 -l -- "cmd".

How do I wait for specific output in a tmux pane?

Use the wait-for-text.sh helper script with a target pane and a regex pattern. It polls the pane history until the pattern matches or the timeout expires, supporting fixed-string matching, custom intervals, and history depth.

Can I run multiple coding agents in parallel with tmux?

Yes, create one tmux session per agent on a shared socket, send each a command in its own working directory, then poll panes for the shell prompt to detect completion. Separate git worktrees avoid branch conflicts between agents.

Does tmux automation work on Windows?

tmux is supported natively on macOS and Linux only. On Windows, install tmux inside WSL and run the automation there, since this Skill is gated to the darwin and linux platforms.

Why does send-keys break with Python REPLs?

The enhanced Python REPL interferes with send-keys input flows. Set PYTHON_BASIC_REPL=1 before launching python3 to force the basic REPL, which accepts scripted keystrokes reliably.