tmux-team

wkh237's avatarfrom wkh237

Communicate with other AI agents in tmux panes. Use when you need to talk to codex, claude, gemini, or other agents.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 31, 2025
[Tool Routing and Orchestration]

When & Why to Use This Skill

The tmux-team Claude skill is a powerful multi-agent orchestration tool designed for terminal-based environments. It enables seamless communication between different AI agents (such as Codex, Gemini, and Claude) operating within tmux panes. By providing a structured CLI for sending messages, broadcasting commands, and retrieving responses, it transforms a standard terminal into a collaborative workspace where multiple specialized AI models can work together on complex tasks in real-time.

Use Cases

  • Multi-Agent Collaborative Coding: Use Claude to architect a project while delegating specific module implementation or code reviews to other agents like Codex in separate tmux panes.
  • Cross-Model Verification and Fact-Checking: Send the same prompt to multiple AI agents simultaneously using the broadcast feature to compare outputs and ensure the highest accuracy for critical information.
  • Asynchronous Workflow Management: Delegate time-consuming tasks to background agents with specific timeouts and delays, allowing the primary agent to continue working while periodically checking for updates.
  • Complex Debugging Pipelines: Orchestrate a workflow where one agent generates test cases, another runs the debugger, and a third analyzes the logs, all coordinated through the tmux-team interface.
nametmux-team
descriptionCommunicate with other AI agents in tmux panes. Use when you need to talk to codex, claude, gemini, or other agents.

When invoked, execute the tmux-team command with the provided arguments.

You are working in a multi-agent tmux environment. Use the tmux-team CLI to communicate with other agents.

Commands

# Send message to an agent
tmux-team talk codex "your message"
tmux-team talk gemini "your message"
tmux-team talk all "broadcast message"

# Send with delay (useful for rate limiting)
tmux-team talk codex "message" --delay 5

# Send and wait for response (blocks until agent replies)
tmux-team talk codex "message" --wait --timeout 120

# Read agent response (default: 100 lines)
tmux-team check codex
tmux-team check gemini 200

# List all configured agents
tmux-team list

Workflow

  1. Send message: tmux-team talk codex "Review this code"
  2. Wait 5-15 seconds (or use --wait flag)
  3. Read response: tmux-team check codex
  4. If response is cut off: tmux-team check codex 200

Notes

  • talk sends via tmux buffer paste, then waits briefly before Enter
  • Control the delay with pasteEnterDelayMs in config (default: 500)
  • Use --delay instead of sleep (safer for tool whitelists)
  • Use --wait for synchronous request-response patterns
  • Run tmux-team help for full CLI documentation