# smux

> One-command tmux setup with terminal automation and a CLI bridge for AI agent-to-agent communication across panes.

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.*

## Features
- One-command install via curl
- tmux-bridge CLI for cross-pane agent communication
- Option-key bindings with no prefix required
- Mouse support with auto-copy to clipboard
- Agent-to-agent communication across panes
- AI Agent Skills integration via npx skills add
- Auto-tiling on new pane creation
- Pane labeling and addressing by name
- Read, type, and send keys to any pane programmatically
- Update and uninstall commands
- Compatible with Claude Code, Codex, Cursor, Copilot, and 40+ agents

## Integrations
Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, Homebrew, apt, dnf, pacman, apk

## Platforms
WINDOWS, MACOS, LINUX, API, CLI

## Pricing
Open Source

## Links
- Website: https://github.com/ShawnPana/smux
- Documentation: https://github.com/ShawnPana/smux/blob/main/skills/smux/SKILL.md
- Repository: https://github.com/ShawnPana/smux
- EveryDev.ai: https://www.everydev.ai/tools/smux