Automation
Plugin
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 —
Plugin Signal62/100Solid
maintained93
capable14
documented75
adopted68
Install
$ npx -y skills add shawnpana/smux --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Stats
1,508
Stars
88
Forks
Active
Maintenance
Shell
Language
MIT
License
12d ago
Last commit
5mo ago
Created
Repo: shawnpana/smux
What's inside
README
1smux
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 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)
File tree
10shawnpana/smuxView on GitHub
.gitignore
.tmux.conf
ghostty/
config
install.sh
LICENSE
README.md
scripts/
tmux-bridge
skills/
smux/
references/
tmux-bridge.md
tmux.md
SKILL.mdFAQ
smux is a Claude Code plugin with 1 hand-picked skill for automation work, indexed on Flowy. Install it with the command on its page. It includes smux. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is 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 —
- How do I install smux?
- Run these in Claude Code: npx -y skills add shawnpana/smux --agent claude-code. Then prompt normally.
- Does smux auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is smux free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.