smux

The smux skill provides advanced control over tmux panes and facilitates communication between AI agents within a tmux environment. It is designed to streamline interactions in multi-pane setups, allowing users to manage tmux sessions, send messages between agents, read pane contents, and control processes directly. By using smux, users can automate inter-agent communication without relying on manual polling or repeated checks, ensuring more efficient workflow coordination and reducing the risk of command errors when managing complex terminal sessions.

At its core, smux offers a dual approach: high-level agent-to-agent communication via the tmux-bridge CLI and low-level session control through raw tmux commands. tmux-bridge enforces a read-before-act mechanism, ensuring every interaction follows a read → act → read cycle. This CLI supports atomic operations such as typing text, sending special keys, reading pane content, labeling panes, and resolving targets. It simplifies cross-pane messaging, automatically appending sender information and directing replies into the initiating pane, thereby eliminating the need for manual polling or verification loops. Raw tmux commands remain available for users who require direct manipulation of tmux sessions or need to interact with non-agent panes.

Typical use cases for smux include collaborative agent workflows, automated code reviews, multi-agent task orchestration, and session management in development environments. Target users are developers, DevOps engineers, and AI practitioners who leverage tmux for multi-pane terminal setups and need reliable, automated communication between agents. By integrating smux into their workflow, these users can maintain efficient pane control, ensure message integrity, and improve productivity when coordinating multiple agents or processes across tmux sessions.