Agent skill · software engineering · sundial-org
tmux
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
Why this skill is useful
Adds specific tmux commands and scripts for orchestrating coding agents that are not commonly known.
What it needs
Requires tmux installed locally. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
tmux Skill (Clawdbot) Use tmux only when you need an interactive TTY. Prefer bash background mode for long-running, non-interactive tasks. Quickstart (isolated socket, bash tool) After starting a session, always print monitor commands: Socket convention Use CLAWDBOTTMUXSOCKETDIR (default ${TMPDIR:-/tmp}/clawdbot-tmux-sockets). Default socket path: "$CLAWDBOTTMUXSOCKETDIR/clawdbot.sock". Targeting panes and naming Target format: session:window.pane (defaults to :0.0). Keep names short; avoid spaces. Inspect: tmux -S "$SOCKET" list-sessions, tmux -S "$SOCKET" list-panes -a. Finding sessions List sessions on your socket: {baseDir}/scripts/find-sessions.sh -S "$SOCKET". Scan all sockets: {baseDir}/scripts/find-sessions.sh --all (uses CLAWDBOTTMUXSOCKETDIR). Sending input safely Prefer literal sends: tmux -S "$SOCKET" send-keys -t target -l -- "$cmd". Control keys: tmux -S "$SOCKET" send-keys -t target C-c. Watching output Capture recent history: tmux -S "$SOCKET" capture-pane -p -J -t target -S -200. Wait for prompts: {baseDir}/scripts/wait-for-text.sh -t session:0.0 -p 'pattern'. Attaching is OK; detach with Ctrl+b d. Spawning processes For python REPLs, set PYTHONBASICREPL=1 (non-basic REPL breaks send-keys flows). Windows / WSL tmux is supported on macOS/Linux. On Windows, use WSL and install tmux inside WSL. This skill is gated to darwin/linux and requires tmux on PATH. Orchestrating Coding Agents (Codex, Claude Code) tmux excels at running multiple coding agents in parallel: Tips: Use separate git worktrees for parallel fixes (no branch conflicts) pnpm install first before running codex in fresh clones Check for shell prompt (❯ or $) to detect completion Codex needs --yolo or --full-auto for non-interactive fixes Cleanup Kill a session: tmux -S "$SOCKET" kill-session -t "$SESSION". Kill all sessions on a socket: tmux -S "$SOCKET" list-sessions -F '#{sessionname}' xargs -r -n1 tmux -S "$SOCKET" kill-session -t. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/tmux