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 —
tmux-bridgeCLI 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.
tmux-bridge read codex 20 # read the pane
tmux-bridge type codex "review src/auth.ts" # type into it
tmux-bridge keys codex Enter # press entertmux-bridge.mp4
curl -fsSL https://shawnpana.com/smux/install.sh | bashThis installs:
- tmux if not already installed (via Homebrew, apt, dnf, pacman, or apk)
- tmux.conf with Option-key bindings, mouse support, pane labels, and a minimal status bar
- tmux-bridge CLI for cross-pane agent communication
Everything lives in ~/.smux/.
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 |
Option+g |
Mark pane |
Option+y |
Swap with marked pane |
| Key | Action |
|---|---|
Option+m |
New window |
Option+u |
Next window |
Option+h |
Previous window |
| Key | Action |
|---|---|
Option+Tab |
Toggle scroll mode |
i/k |
Scroll up/down |
Shift+I/K |
Half-page up/down |
q or Escape |
Exit scroll mode |
- Click to select panes
- Drag to select text (auto-copies to clipboard)
- Scroll wheel to scroll
A CLI for cross-pane communication. Any tool that can run bash can use it — Claude Code, Codex, Gemini CLI, or a plain shell script.
| Command | Description |
|---|---|
tmux-bridge list |
Show all panes with target, process, label |
tmux-bridge read <target> [lines] |
Read last N lines from a pane |
tmux-bridge type <target> <text> |
Type text into a pane (no Enter) |
tmux-bridge keys <target> <key>... |
Send keys (Enter, Escape, C-c, etc.) |
tmux-bridge name <target> <label> |
Label a pane for easy addressing |
tmux-bridge resolve <label> |
Look up a pane by label |
tmux-bridge id |
Print this pane's ID |
See the smux skill for full documentation on agent-to-agent workflows.
smux updatesmux uninstallInstall the smux skill to teach your agents how to use tmux-bridge:
npx skills add ShawnPana/smuxWorks with Claude Code, Codex, Cursor, Copilot, and 40+ other agents.
- macOS (requires Homebrew) or Linux
- tmux 3.2+ (installed automatically)