orchestrating-tmux-claudes

Coordinate multiple AI agents across tmux panes with verification and auto-approval.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dbmcco/claude-agent-toolkit --skill orchestrating-tmux-claudes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orchestrating-tmux-claudes
Source: https://github.com/dbmcco/claude-agent-toolkit/tree/main/skills/orchestrating-tmux-claudes
Command: npx skills add https://github.com/dbmcco/claude-agent-toolkit --skill orchestrating-tmux-claudes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, Node.js, Claude Code CLI, Git.

What problem does it solve?

This Skill eliminates the manual overhead and complexity of coordinating multiple AI agents for intricate, multi-stage development workflows, ensuring tasks are completed efficiently and reliably.

Core Features & Use Cases

  • Multi-AI Orchestration: Coordinate multiple AI instances (Claude Code, codex, ollama, haiku) in parallel or sequential workflows within tmux panes.
  • Auto-Recovery & Monitoring: Automatically detect and recover stuck agents, ensuring continuous progress and reducing manual intervention.
  • Role-Based Skill Loading: Enforce a coordinator-only role for the main Claude instance, preventing worker agents from self-orchestrating.
  • Use Case: Implement a complex TDD feature by delegating test writing, implementation, refactoring, and code review to specialized AI agents, all orchestrated from a single tmux session.

Quick Start

Launch a multi-AI tmux session

~/.claude/scripts/launch-claude-team.sh .

Attach to the session to begin orchestrating

tmux attach -t claude-team

Frequently Asked Questions about orchestrating-tmux-claudes

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

FAQPage Schema
How do I coordinate multiple AI agents in tmux for parallel development tasks?

Coordinate multiple AI agents in tmux by launching a multi-AI session with Claude Code, codex, ollama, or haiku instances across separate panes, then orchestrate their workflows from a coordinator instance that monitors outputs, verifies quality gates, and issues commands with guaranteed execution via Enter as a separate argument.

Can I automate complex multi-stage workflows across different AI agents?

Yes. Multi-agent orchestration automates complex workflows by delegating specialized tasks—test writing, implementation, refactoring, code review—to separate AI agents within a single tmux session, with the coordinator handling real-time monitoring, auto-recovery, and role-based task routing.

What are the prerequisites for setting up multi-AI orchestration in tmux?

Prerequisites include tmux, Node.js, Claude Code CLI, and Git. The orchestration reads pane outputs before decisions, logs breadcrumbs to /tmp, and executes actual bash commands without hallucination, requiring these tools installed and Git initialized in your project.

How do I prevent worker agents from self-orchestrating in a multi-AI setup?

Enforce role-based skill loading by restricting the coordinator role to the main Claude instance only, preventing worker agents from attempting self-orchestration and ensuring clean separation of concerns across the tmux session.

What happens when an AI agent gets stuck during orchestrated tasks?

Auto-recovery monitoring detects stuck agents and automatically recovers them, ensuring continuous progress through the workflow and reducing manual intervention overhead in long-running multi-stage development processes.

Does tmux orchestration support both parallel and sequential agent workflows?

Yes. Tmux orchestration coordinates AI agents in either parallel or sequential workflows within separate panes, with the coordinator deciding execution order and managing inter-agent dependencies based on quality gates and verification outcomes.