smux

Coordinate AI agent messaging and pane control across tmux sessions.

2.5k|134|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/compozy/compozy --skill smux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smux
Source: https://github.com/compozy/compozy/tree/main/.agents/skills/smux
Command: npx skills add https://github.com/compozy/compozy --skill smux

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Tidy cross-pane collaboration by providing controlled tmux pane management and a high-level CLI (tmux-bridge) for agent-to-agent messaging within a shared terminal.

Core Features & Use Cases

  • Tmux pane control and cross-pane communication for AI agents.
  • Use tmux-bridge for agent messaging and session coordination; fall back to raw tmux commands when low-level control is needed.
  • Example: coordinate multiple agents to exchange prompts, share pane content, and manage tmux sessions during complex task loops.

Quick Start

Label a pane for an agent and start cross-pane messaging with tmux-bridge.

Frequently Asked Questions about smux

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multiple AI agents running in separate tmux panes?

You can coordinate multiple AI agents across tmux panes by using tmux-bridge for high-level agent-to-agent messaging and pane control. It enables cross-pane communication by letting agents exchange prompts, share outputs, and manage sessions within a shared terminal.

Can I use raw tmux commands for cross-pane agent communication instead of a CLI bridge?

Yes, you can use raw tmux commands for low-level pane control when detailed session management is needed. The skill provides tmux-bridge for high-level agent messaging but supports falling back to native tmux commands for direct terminal manipulation.

What is the best way to share pane outputs between AI agents in a single terminal?

The best way to share pane outputs between agents is using tmux-bridge to route messages across labeled panes. This allows agents running in the same tmux session to exchange prompts and retrieve content from other panes for coordinated task loops.

Do I need to label tmux panes before starting cross-pane messaging with AI agents?

Yes, you need to label a pane for an agent before initiating cross-pane messaging. Assigning labels ensures that tmux-bridge can accurately target specific agents and route messages to the correct panes during multi-agent session coordination.

Why use tmux-bridge for multi-agent session control instead of manual terminal splitting?

Using tmux-bridge for multi-agent session control provides structured cross-pane communication, preventing the clutter of manual terminal splitting. It offers a high-level CLI to manage complex task loops, exchange prompts, and coordinate agent sessions cleanly within one tmux environment.