> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/ComposioHQ/agent-orchestrator/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Orchestrator

> Orchestration framework for managing parallel AI coding agents

<div className="relative overflow-hidden bg-gradient-to-br from-[#0f1117] via-[#1a1d27] to-[#0f1117] dark:from-[#0f1117] dark:via-[#1a1d27] dark:to-[#0f1117] py-20 border-b border-[#27272a] dark:border-[#27272a]">
  <div className="absolute inset-0 bg-grid-pattern opacity-5" />

  <div className="relative max-w-6xl mx-auto px-6 lg:px-8">
    <div className="grid lg:grid-cols-12 gap-12 items-center">
      <div className="lg:col-span-7">
        <h1 className="text-5xl lg:text-6xl font-bold text-gray-100 dark:text-gray-100 mb-6 leading-tight">
          Orchestrate Parallel AI Coding Agents
        </h1>

        <p className="text-xl text-gray-400 dark:text-gray-400 mb-8 max-w-2xl leading-relaxed">
          Spawn multiple AI agents working simultaneously on different tasks across your codebase. Each agent gets its own isolated workspace, handles CI failures automatically, and pushes notifications only when human judgment is needed.
        </p>

        <div className="flex flex-wrap gap-4">
          <a href="/quickstart" className="inline-flex items-center px-6 py-3 rounded-lg bg-[#848c84] hover:bg-[#6a726a] text-white font-semibold transition-colors no-underline">
            Get Started

            <svg className="ml-2 w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 7l5 5m0 0l-5 5m5-5H6" />
            </svg>
          </a>

          <a href="/concepts/architecture" className="inline-flex items-center px-6 py-3 rounded-lg border border-[#27272a] dark:border-[#27272a] bg-[#1a1d27]/50 dark:bg-[#1a1d27]/50 hover:bg-[#242838] dark:hover:bg-[#242838] text-gray-100 dark:text-gray-100 font-semibold transition-colors no-underline">
            Learn Architecture
          </a>
        </div>

        <div className="mt-8 flex flex-wrap gap-6 text-sm text-gray-400 dark:text-gray-400">
          <div className="flex items-center gap-2">
            <svg className="w-5 h-5 text-[#848c84]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
            </svg>

            <span>8 Plugin Slots</span>
          </div>

          <div className="flex items-center gap-2">
            <svg className="w-5 h-5 text-[#848c84]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
            </svg>

            <span>Git Worktree Isolation</span>
          </div>

          <div className="flex items-center gap-2">
            <svg className="w-5 h-5 text-[#848c84]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
            </svg>

            <span>Auto CI Fixes</span>
          </div>
        </div>
      </div>

      <div className="lg:col-span-5 hidden lg:block">
        <div className="relative">
          <div className="absolute -inset-4 bg-gradient-to-r from-[#848c84]/20 to-transparent blur-2xl" />

          <div className="relative bg-[#1a1d27] dark:bg-[#1a1d27] rounded-2xl border border-[#27272a] dark:border-[#27272a] p-6 shadow-2xl">
            <div className="flex items-center gap-2 mb-4 pb-3 border-b border-[#27272a] dark:border-[#27272a]">
              <div className="w-3 h-3 rounded-full bg-red-500" />

              <div className="w-3 h-3 rounded-full bg-yellow-500" />

              <div className="w-3 h-3 rounded-full bg-green-500" />

              <span className="ml-2 text-sm text-gray-400 dark:text-gray-400 font-mono">terminal</span>
            </div>

            <div className="font-mono text-sm space-y-2">
              <div className="text-gray-400 dark:text-gray-400">$ <span className="text-[#848c84]">ao spawn</span> my-project <span className="text-blue-400">123</span></div>               <div className="text-gray-500 dark:text-gray-500">✓ Created worktree at ~/.worktrees/my-project-1</div>               <div className="text-gray-500 dark:text-gray-500">✓ Started tmux session: my-project-1</div>               <div className="text-gray-500 dark:text-gray-500">✓ Launched Claude Code agent</div>               <div className="text-green-400 mt-4">Session spawned: my-project-1</div>               <div className="text-gray-400 dark:text-gray-400 mt-4">$ <span className="text-[#848c84]">ao status</span></div>
              <div className="text-gray-500 dark:text-gray-500">my-project-1  working   feat/issue-123</div>
              <div className="text-gray-500 dark:text-gray-500">my-project-2  pr\_open   feat/issue-124</div>
            </div>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">Quick Start</h2>
  <p className="text-lg text-gray-600 dark:text-gray-400 mb-8">Get Agent Orchestrator running in minutes</p>

  <Steps>
    <Step title="Install Agent Orchestrator">
      Clone the repository and run the setup script to install dependencies and configure your environment.

      ```bash theme={null}
      git clone https://github.com/ComposioHQ/agent-orchestrator.git
      cd agent-orchestrator
      bash scripts/setup.sh
      ```

      <Note>Requires Node.js 20+, Git 2.25+, tmux, and the `gh` CLI for GitHub integration.</Note>
    </Step>

    <Step title="Initialize your project">
      Run the interactive init command to create your configuration file, or start from a repository URL.

      ```bash theme={null}
      # Option A: From existing local repo
      cd ~/your-project
      ao init --auto

      # Option B: From a GitHub URL
      ao start https://github.com/your-org/your-repo
      ```

      This creates `agent-orchestrator.yaml` with auto-detected settings for your project.
    </Step>

    <Step title="Start the orchestrator and spawn an agent">
      Launch the web dashboard and spawn your first agent session.

      ```bash theme={null}
      ao start
      ao spawn my-project 123
      ```

      The dashboard opens at `http://localhost:3000` where you can monitor all active sessions in real-time.
    </Step>
  </Steps>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">Explore by Topic</h2>
  <p className="text-lg text-gray-600 dark:text-gray-400 mb-8">Deep dive into Agent Orchestrator's capabilities</p>

  <CardGroup cols={2}>
    <Card title="Core Concepts" icon="lightbulb" href="/concepts/architecture">
      Understand the plugin architecture, session lifecycle, and how the orchestrator coordinates parallel agents.
    </Card>

    <Card title="CLI Reference" icon="terminal" href="/cli/overview">
      Complete command reference for spawning agents, managing sessions, and controlling the orchestrator.
    </Card>

    <Card title="Plugin System" icon="plug" href="/plugins/overview">
      Explore the 8 plugin slots: Runtime, Agent, Workspace, Tracker, SCM, Notifier, Terminal, and Lifecycle.
    </Card>

    <Card title="Configuration Guide" icon="gear" href="/configuration/overview">
      Configure projects, reactions, notifications, and per-project overrides in agent-orchestrator.yaml.
    </Card>
  </CardGroup>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">Key Features</h2>
  <p className="text-lg text-gray-600 dark:text-gray-400 mb-8">Everything you need to orchestrate AI coding agents at scale</p>

  <div className="grid md:grid-cols-2 gap-6">
    <div className="p-6 rounded-xl border border-gray-200 dark:border-[#27272a] bg-white dark:bg-[#1a1d27] hover:border-[#848c84] dark:hover:border-[#848c84] transition-colors">
      <div className="w-12 h-12 rounded-lg bg-[#848c84]/10 dark:bg-[#848c84]/10 flex items-center justify-center mb-4">
        <svg className="w-6 h-6 text-[#848c84]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
        </svg>
      </div>

      <h3 className="text-lg font-semibold text-gray-900 dark:text-white mb-2">Plugin Architecture</h3>
      <p className="text-gray-600 dark:text-gray-400 text-sm">Eight swappable plugin slots for runtime, agent, workspace, tracker, SCM, notifier, terminal, and lifecycle management.</p>
    </div>

    <div className="p-6 rounded-xl border border-gray-200 dark:border-[#27272a] bg-white dark:bg-[#1a1d27] hover:border-[#848c84] dark:hover:border-[#848c84] transition-colors">
      <div className="w-12 h-12 rounded-lg bg-[#848c84]/10 dark:bg-[#848c84]/10 flex items-center justify-center mb-4">
        <svg className="w-6 h-6 text-[#848c84]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M3 10h18M3 14h18m-9-4v8m-7 0h14a2 2 0 002-2V8a2 2 0 00-2-2H5a2 2 0 00-2 2v8a2 2 0 002 2z" />
        </svg>
      </div>

      <h3 className="text-lg font-semibold text-gray-900 dark:text-white mb-2">Parallel Execution</h3>
      <p className="text-gray-600 dark:text-gray-400 text-sm">Run multiple agents simultaneously, each in isolated git worktrees with separate branches and PRs.</p>
    </div>

    <div className="p-6 rounded-xl border border-gray-200 dark:border-[#27272a] bg-white dark:bg-[#1a1d27] hover:border-[#848c84] dark:hover:border-[#848c84] transition-colors">
      <div className="w-12 h-12 rounded-lg bg-[#848c84]/10 dark:bg-[#848c84]/10 flex items-center justify-center mb-4">
        <svg className="w-6 h-6 text-[#848c84]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
        </svg>
      </div>

      <h3 className="text-lg font-semibold text-gray-900 dark:text-white mb-2">Auto Reactions</h3>
      <p className="text-gray-600 dark:text-gray-400 text-sm">Automatically handle CI failures and review comments. Agents fix issues autonomously and notify you only when needed.</p>
    </div>

    <div className="p-6 rounded-xl border border-gray-200 dark:border-[#27272a] bg-white dark:bg-[#1a1d27] hover:border-[#848c84] dark:hover:border-[#848c84] transition-colors">
      <div className="w-12 h-12 rounded-lg bg-[#848c84]/10 dark:bg-[#848c84]/10 flex items-center justify-center mb-4">
        <svg className="w-6 h-6 text-[#848c84]" fill="none" stroke="currentColor" viewBox="0 0 24 24">
          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M7 21a4 4 0 01-4-4V5a2 2 0 012-2h4a2 2 0 012 2v12a4 4 0 01-4 4zm0 0h12a2 2 0 002-2v-4a2 2 0 00-2-2h-2.343M11 7.343l1.657-1.657a2 2 0 012.828 0l2.829 2.829a2 2 0 010 2.828l-8.486 8.485M7 17h.01" />
        </svg>
      </div>

      <h3 className="text-lg font-semibold text-gray-900 dark:text-white mb-2">Agent Agnostic</h3>
      <p className="text-gray-600 dark:text-gray-400 text-sm">Works with Claude Code, Codex, Aider, OpenCode, and any AI coding tool through the Agent plugin interface.</p>
    </div>
  </div>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">Resources</h2>
  <p className="text-lg text-gray-600 dark:text-gray-400 mb-8">Learn more and get support</p>

  <CardGroup cols={3}>
    <Card title="Example Configs" icon="file-code" href="/resources/examples">
      Ready-to-use configuration examples for GitHub, Linear, multi-project setups, and auto-merge workflows.
    </Card>

    <Card title="Troubleshooting" icon="wrench" href="/resources/troubleshooting">
      Solutions to common issues with tmux sessions, git worktrees, and agent connectivity.
    </Card>

    <Card title="Contributing" icon="code-pull-request" href="/resources/contributing">
      Learn how to build custom plugins and contribute to the Agent Orchestrator project.
    </Card>
  </CardGroup>
</div>

<div className="mt-20 mb-16 max-w-5xl mx-auto px-6">
  <div className="rounded-2xl bg-gradient-to-br from-[#1a1d27] to-[#0f1117] dark:from-[#1a1d27] dark:to-[#0f1117] border border-[#27272a] dark:border-[#27272a] p-12 text-center">
    <h2 className="text-3xl font-bold text-gray-100 dark:text-gray-100 mb-4">Ready to orchestrate your agents?</h2>

    <p className="text-xl text-gray-400 dark:text-gray-400 mb-8 max-w-2xl mx-auto">
      Start managing parallel AI coding agents across your codebase today.
    </p>

    <a href="/quickstart" className="inline-flex items-center px-8 py-4 rounded-lg bg-[#848c84] hover:bg-[#6a726a] text-white font-semibold text-lg transition-colors no-underline">
      Get Started Now

      <svg className="ml-2 w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 7l5 5m0 0l-5 5m5-5H6" />
      </svg>
    </a>
  </div>
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.