explaingit

composiohq/agent-orchestrator

7,015TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

TLDR

Runs multiple AI coding agents like Claude Code, Codex, or Aider in parallel on separate git branches, with a web dashboard to monitor tasks and automatically fix CI failures.

Mindmap

mindmap
  root((Agent Orchestrator))
    What it does
      Run agents in parallel
      Isolated git worktrees
      Auto open pull requests
      Auto fix CI failures
    Supported agents
      Claude Code
      Codex
      Aider
    Dashboard
      Web UI port 3000
      Per-agent status
      Review comment routing
    Setup
      npm install
      YAML config file
      GitHub integration
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Run 10 AI coding agents simultaneously on different GitHub issues so tasks finish in parallel.

USE CASE 2

Automatically retry and fix CI failures on agent-created pull requests without human intervention.

USE CASE 3

Route PR review comments back to the responsible AI agent to apply requested changes automatically.

USE CASE 4

Set up a hands-off coding pipeline that opens, fixes, and merges PRs end-to-end.

Tech stack

TypeScriptNode.jsnpmtmuxYAML

Getting it running

Difficulty · easy Time to first run · 30min

Requires tmux on Mac or Linux, Windows uses a native process mode instead.

MIT license, use freely for any purpose, including commercial, with no restrictions beyond keeping the copyright notice.

In plain English

Agent Orchestrator is a tool for running multiple AI coding agents in parallel on a software project. The idea is that instead of having one AI agent work through tasks one at a time, you can have many agents working simultaneously on different issues or tasks, each isolated in its own copy of the codebase. A central orchestrator coordinates what each agent is doing, and a web dashboard at localhost:3000 shows you the status of all agents at a glance. Each agent gets its own git worktree, which means it has its own branch and its own separate working directory so agents do not interfere with each other. When an agent finishes a task, it opens a pull request. If automated tests (CI) fail on that pull request, the agent receives the failure details and tries to fix them on its own. If a code reviewer leaves comments requesting changes, those comments are routed back to the agent automatically. The goal is that you only have to intervene when something requires a human decision, like approving and merging a pull request. The tool works with several AI coding agents out of the box, including Claude Code, Codex, and Aider. It supports running on macOS, Linux, and Windows. On Mac and Linux it uses tmux (a terminal session manager) to run agents, on Windows it uses a native process approach instead. It can integrate with GitHub for pull requests and issue tracking. Setting it up takes one npm install command and one start command. The start command points at a repository, opens the dashboard, and starts the orchestrator agent. Configuration lives in a YAML file that is generated automatically and can be edited to adjust which agent to use, how many retries to attempt on CI failures, and whether to auto-merge approved pull requests. The project is aimed at developers who want to run many AI coding tasks in parallel without manually babysitting each one. It is MIT licensed and available as an npm package.

Copy-paste prompts

Prompt 1
I am using composiohq/agent-orchestrator with Claude Code. Write the YAML config to run 5 agents in parallel on my GitHub repo, auto-merge approved PRs, and retry CI failures up to 3 times.
Prompt 2
Set up agent-orchestrator to pull open issues labeled good-first-issue from my repo and assign one AI agent per issue automatically.
Prompt 3
I am getting errors when agent-orchestrator tries to open pull requests. Show me how to configure the GitHub integration with a personal access token.
Prompt 4
Using agent-orchestrator, how do I add a custom agent runner for a tool that is not Claude Code, Codex, or Aider?
Open on GitHub → Explain another repo

← composiohq on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.