tmux

Control interactive terminal programs, REPLs, and TUI tools through tmux sessions.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/pgoell/pgoell-claude-tools --skill tmux-pgoell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/pgoell/pgoell-claude-tools/tree/main/plugins/terminal/skills/tmux
Command: npx skills add https://github.com/pgoell/pgoell-claude-tools --skill tmux-pgoell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux.

What problem does it solve? Interactive CLIs like REPLs, debuggers, and full-screen TUI tools require a persistent TTY and cannot be driven by plain one-shot shell commands, making them hard for an agent to operate and observe. ## Core Features & Use Cases - Session Management: Create, list, monitor, and kill tmux sessions on a private socket so agent-controlled panes stay separate from the user's personal tmux server. - Keystroke and Output Control: Send literal text and control keys to panes, capture pane output, and poll for prompts to synchronize with interactive programs. - Use Case: Start a Python REPL in a detached tmux session, send code line by line, capture the output after each command, and leave a monitor command so the user can attach and watch the session live. ## Quick Start Use tmux to start a Python REPL in a detached session, send it a few commands, and show me the captured output.

Frequently Asked Questions about tmux

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

FAQPage Schema
How do I control an interactive CLI program from a script?

Run the program inside a detached tmux session, then use tmux send-keys to send literal text and Enter, and capture-pane to read the output. Poll the pane content until the expected prompt appears before sending the next command.

How to send keys and read output from a tmux pane?

Use tmux send-keys with the -l flag for literal text followed by a separate Enter key, then read results with tmux capture-pane -p -J targeting the session and pane. Add -S -200 to capture scrollback history.

Does tmux work on Windows for terminal automation?

tmux does not run natively on Windows terminals. The recommended approach is to install WSL and run tmux inside the Linux environment, where it works the same as on Linux or macOS.

Why does my tmux send-keys command fail or target the wrong pane?

Failures usually come from a missing session, a dead socket, or wrong pane indexes on configs that start window indexes at 1. Run tmux list-sessions and list-panes on the socket, and target the active pane with session:. notation.

When should I use tmux instead of a plain shell command?

Use tmux only for programs that require a persistent TTY, such as REPLs, debuggers, and full-screen TUI tools. For non-interactive work, plain shell commands are simpler and more reliable.