One-command tmux setup with terminal automation for AI agents.
- For you — keyboard-driven tmux config with Option-key bindings, mouse support, and pane labels
- For agents —
smuxCLI lets any agent read, type, and send keys to any pane - Agent-to-agent — Claude Code can prompt Codex in the next pane, and Codex replies back. Any agent that can run bash can participate.
smux read codex 20 # read the pane
smux type codex "ls -la" # type into it
smux keys codex Enter # press entertmux-bridge.mp4
curl -fsSL https://shawnpana.com/smux/install.sh | bashA CLI for cross-pane communication and management. Any tool that can run bash can use it — Claude Code, Codex, Gemini CLI, or a plain shell script.
| Command | Description |
|---|---|
smux list |
Show all panes with target, process, label |
smux name <target> <label> |
Label a pane for easy addressing |
smux read <target> [lines] |
Read last N lines from a pane |
smux type <target> <text> |
Type text into a pane (no Enter) |
smux keys <target> <key>... |
Send keys (Enter, Escape, C-c, etc.) |
smux doctor |
Diagnose install issues |
All keybindings use Option (Alt) with no prefix required.
| Key | Action |
|---|---|
Option+i/k/j/l |
Navigate up/down/left/right (no wrap) |
Option+n |
New pane (split + auto-tile) |
Option+w |
Close pane |
Option+o |
Cycle layouts |
| Key | Action |
|---|---|
Option+m |
New window |
Option+u |
Next window |
Option+h |
Previous window |
Install the smux skill to teach your agents how to use smux:
npx skills add ShawnPana/smuxWorks with Claude Code, Codex, Cursor, Copilot, and 40+ other agents.