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.