tmux Remote Control

What it does

This skill provides scripted best-practices and helper commands for managing tmux sockets and sessions on macOS/Linux. It adds the ability to create isolated tmux sockets, send typed input safely (text then Enter with adjustable delays), capture pane history, find and list sessions, and orchestrate multiple agent sessions in parallel. The guidance covers socket conventions, pane targeting, sending control keys, watching output, spawning processes, and safe cleanup. Concrete examples include starting sessions with isolated sockets, sending commands to Claude Code/Codex TUI agents, polling for prompts, and extracting pane captures for logs.

When to use it

Use this skill whenever an interactive TTY is required: running TUI-based coding agents, debugging interactive REPLs, driving terminal UIs, or orchestrating multiple parallel agents that need separate sessions. Prefer it for short-lived interactive flows; for long-running non-interactive tasks use background exec instead. It's especially useful on darwin/linux hosts where tmux is available.

What's included

• Scripts: scripts to find sessions, wait-for-text polling helper, and orchestration snippets (has_scripts=true).
• References: inline procedural guidance and examples for targeting panes, sending keys safely, capturing output, and cleanup.
• Instructions: step-by-step quickstart for creating isolated sockets, sample send-keys patterns (split text + Enter with delay), monitoring commands, and cleanup commands.

Compatible agents

Designed for environments that run terminal-based agents and CLIs (e.g., Claude Code, Codex, Codex TUI, local CLI agents). Works on systems where tmux is installed and accessible from the agent runtime.