What problem does it solve?
smux solves the coordination problem of interacting with multiple tmux panes and AI agents by providing a safe, read-guarded way to send messages and trigger input across panes without fragile manual timing.
Core Features & Use Cases
- Cross-pane agent communication: Use tmux-bridge to send messages to an AI agent running in another pane and receive the reply directly in your pane.
- Enforced read–act–read workflow: Prevents mistimed input by requiring a read-before-interact cycle for every type/keys action.
- Pane discovery and targeting: List panes, label panes, resolve labels to targets, and address panes by native target IDs or labels.
- Fallback to raw tmux: Use direct tmux commands for low-level session/pane management when tmux-bridge isn’t sufficient.
Quick Start
Send a cross-pane message to another agent running in tmux by reading the target pane, sending a message, reading again to verify it landed, and then pressing Enter.