shawnpana-smux

smux

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-bridge CLI 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 enter

https://github.com/user-attachments/assets/9d5463ba-5972-4bbd-a07e-b585f1178011

Install

curl -fsSL https://shawnpana.com/smux/install.sh | bash

This 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/.

Keybindings

All keybindings use Option (Alt) with no prefix required.

Panes

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

Windows

Key	Action
Option+m	New window
Option+u	Next window
Option+h	Previous window

Scrolling

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

Mouse

• Click to select panes
• Drag to select text (auto-copies to clipboard)
• Scroll wheel to scroll

tmux-bridge

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.

Update

smux update

Uninstall

smux uninstall

AI Agent Skills

Install the smux skill to teach your agents how to use tmux-bridge:

npx skills add ShawnPana/smux

Works with Claude Code, Codex, Cursor, Copilot, and 40+ other agents.

Requirements

• macOS (requires Homebrew) or Linux
• tmux 3.2+ (installed automatically)