tmux

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

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill tmux-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/tmux
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill tmux-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Interactive CLI programs like REPLs, TUI coding agents, and long-running shells cannot be driven through simple one-shot commands. This Skill lets an agent create, control, and monitor tmux sessions so interactive terminal programs can be automated reliably. ## Core Features & Use Cases - Session Control on Isolated Sockets: Create and manage tmux sessions on a dedicated socket directory, keeping agent sessions separate from user sessions. - Safe Input and Output Capture: Send literal keystrokes and control keys to panes, then scrape pane history with capture-pane to read program output. - Helper Scripts: Use find-sessions.sh to list sessions across sockets and wait-for-text.sh to poll a pane until a regex or fixed string appears. - Use Case: Run multiple coding agents (Codex, Claude Code) in parallel tmux sessions, send prompts with delayed Enter keys, and poll for the shell prompt to detect completion. ## Quick Start Ask the agent to start a tmux session on the isolated socket, launch a Python REPL inside it, and capture the pane output to verify it is running.

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, then send Enter as a separate command with a short delay. For TUI apps like Claude Code, combining text and Enter in one send-keys can be misread as paste input.

How to 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 capture-pane output at a configurable interval and exits when the pattern matches or the timeout expires.

Does tmux work on Windows for terminal automation?

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

Why use an isolated tmux socket instead of the default?

An isolated socket under OPENCLAW_TMUX_SOCKET_DIR keeps agent-managed sessions separate from the user's own tmux server. This prevents accidental interference and makes cleanup as simple as killing the private server.

When should I not use tmux for running tasks?

Avoid tmux for long-running non-interactive tasks; background exec mode is simpler and more appropriate. Reserve tmux for programs that genuinely require an interactive TTY, such as REPLs and TUI applications.