smux

smux is an open-source tmux configuration and automation toolkit that installs in a single command, providing a keyboard-driven terminal environment with built-in support for AI agent workflows. It ships a tmux-bridge CLI that lets any agent — Claude Code, Codex, Gemini CLI, or a plain shell script — read from, type into, and send keystrokes to any tmux pane. Agents can coordinate directly: one agent can prompt another in an adjacent pane and receive replies, enabling multi-agent terminal workflows without additional infrastructure. Everything installs to ~/.smux/ and works on macOS (via Homebrew) and Linux.

• One-command install — a single curl | bash installs tmux (if missing), the config, and the tmux-bridge CLI automatically.
• Option-key bindings — all keybindings use Option (Alt) with no prefix required, covering pane navigation, splitting, layout cycling, and window management.
• Mouse support — click to select panes, drag to copy text to clipboard, and scroll wheel navigation are all enabled out of the box.
• tmux-bridge CLI — provides list, read, type, keys, name, resolve, and id subcommands for full cross-pane programmatic control.
• Agent-to-agent communication — any agent that can run bash can participate; Claude Code can prompt Codex in the next pane and Codex replies back.
• AI Agent Skills — install the smux skill via npx skills add ShawnPana/smux to teach agents how to use tmux-bridge; compatible with Claude Code, Codex, Cursor, Copilot, and 40+ other agents.
• Auto-tiling — new panes automatically tile the layout, keeping the workspace organized without manual resizing.
• Update and uninstall commands — smux update and smux uninstall manage the installation lifecycle cleanly.