Tmux

Lets you remote control tmux sessions by sending keystrokes and scraping pane output, which is exactly what you need when managing multiple Claude Code workers or any interactive CLI tool running in tmux. Instead of manually switching between panes, you can programmatically check if a session is waiting for input, send confirmations to prompts, or grab the last 20 lines of output to see what's happening. The docs are thorough about when not to use it, which is refreshing: skip it for one-off commands or anything not already running in tmux. Most useful when you've got several background sessions doing work and need to orchestrate them without babysitting each terminal.

skills.sh installs: 5.3K
GitHub stars: 382.8K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add steipete/clawdis --skill tmux --agent claude-code

Installs into .claude/skills of the current project.

Files

tmux

Use for existing interactive tmux sessions. For one-shot commands, use normal shell. For new non-interactive background jobs, use background execution.

Basics

tmux ls
tmux list-windows -t shared
tmux list-panes -t shared:0
tmux capture-pane -t shared:0.0 -p
tmux capture-pane -t shared:0.0 -p -S -

Target format: session:window.pane, e.g. shared:0.0.

Send input

Literal text, then Enter:

tmux send-keys -t shared:0.0 -l -- "Please continue"
tmux send-keys -t shared:0.0 Enter

Special keys:

tmux send-keys -t shared:0.0 C-c
tmux send-keys -t shared:0.0 C-d
tmux send-keys -t shared:0.0 Escape

Use -l -- for arbitrary text. Split text and Enter to avoid paste/newline surprises.

Sessions

tmux new-session -d -s worker
tmux rename-session -t old new
tmux kill-session -t worker

Prompt checks

tmux capture-pane -t worker-3 -p | tail -20
tmux capture-pane -t worker-3 -p | rg "proceed|permission|Yes|No|❯"

Approve/select only when the prompt is understood:

tmux send-keys -t worker-3 -l -- "y"
tmux send-keys -t worker-3 Enter

Helpers

SKILL.md on GitHub

Details

Repository: github.com/steipete/clawdis
Category: CLI & Terminal