tmux Skill

Control tmux sessions programmatically. Send keys, capture output, run interactive processes.

Cross-platform:

• Linux/macOS: Uses native tmux
• Windows: Uses psmux (native Windows tmux, 95%+ syntax compatible)

Use tmux when:

• SSH to remote servers (persistent sessions)
• Interactive TTY needed (REPLs, shells, prompts)
• Running multiple processes in parallel
• Orchestrating coding agents

Don't use tmux for:

• Simple background tasks → use bg run instead
• One-shot commands → run directly

Helper: tmx

Primary: Python CLI tool (tmx) — installable via agent-sommelier-cli. Fallback: Shell scripts at skills/tmux/scripts/tmx.sh (bash) and tmx.ps1 (PowerShell).

Commands

Quick Start

tmx install
tmx create mysession
tmx run mysession "ls -la"
tmx r mysession
tmx rm mysession

tmx install
tmx create mysession
tmx run mysession "Get-ChildItem"

Pattern 1: SSH Sessions (Most Common)

# Create SSH session
tmx create server "ssh [email protected]"
tmx run server "hostname" --timeout 3
tmx sk server "mypassword"
tmx run server "tail -100 nginx/access.log" --timeout 5
tmx r server

Pattern 2: Background Process Monitoring

tmx create api "cd /app && python api.py"
tmx r api | grep -q "Listening" && echo "API is up"
tmx create db "docker run --name postgres postgres"
tmx list

Pattern 3: Interactive REPL

tmx create python "python3 -q"
tmx run python "import sys; print(sys.version)"
tmx run python "2 + 2" --timeout 3

Pattern 4: Parallel Agents

for i in 1 2 3; do
  tmx create "agent-$i" "cd /tmp/project$i && codex --yolo 'Fix bugs'"
done
tmx list
tmx r agent-1

Key Bindings (when attached)

Deeper Reading