# agentwrapper/agent-orchestrator

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/agentwrapper-agent-orchestrator).**

7,637 stars · 1,046 forks · TypeScript · MIT

## Links

- GitHub: https://github.com/AgentWrapper/agent-orchestrator
- Homepage: https://ao-agents.com
- awesome-repositories: https://awesome-repositories.com/repository/agentwrapper-agent-orchestrator.md

## Topics

`agent-fleet` `agent-swarm` `claude-code` `codex-cli` `git-worktrees` `multi-agent` `orchestration` `orchestrator` `parallel-agents` `parallel-coding` `skills` `tmux`

## Description

This project is an LLM coding agent orchestrator and AI software engineering platform designed to manage fleets of agents that autonomously solve issues, handle pull requests, and fix CI failures. It functions as an agentic CI/CD automator and parallel workflow manager, coordinating the end-to-end development lifecycle from initial ticket tracking to final code merging.

The system is distinguished by its modular plugin framework and isolated worktree management, which allow multiple agents to work on separate coding tasks simultaneously without file system conflicts. It utilizes role-based model routing to assign different large language models to orchestration and execution tasks, balancing high-level reasoning with processing speed.

The platform covers a broad range of capabilities, including automated CI remediation and code review loops that route failure reports and reviewer comments back to agents for iterative fixes. It provides session and workspace management via a centralized dashboard, featuring bidirectional terminal streaming, state-based session persistence, and integrated issue tracking.

The orchestrator is built with a plugin-based architecture that supports swappable components for AI models, execution runtimes, and notification gateways, and it can be deployed within Docker environments.

## Tags

### Artificial Intelligence & ML

- [AI Agent Orchestration](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-agent-orchestration.md) — Provides a unified interface for managing the lifecycle and roles of multiple AI agents across several repositories. ([source](https://ao-agents.com/docs/quickstart/))
- [Event-Driven Agent Loops](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/event-driven-agent-loops.md) — Triggers agent re-activation based on events like CI failures or new pull request comments.
- [Agent Lifecycle Management](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-lifecycle-management.md) — Manages the creation, tracking, and cleanup of AI agent worker sessions based on PR state. ([source](https://ao-agents.com/docs/guides/per-role-agents/))
- [Coding Agent Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/coordination-and-routing/ai-agent-orchestrators/coding-agent-orchestrators.md) — Coordinates multiple AI coding agents in parallel, utilizing isolated worktrees to prevent file system conflicts. ([source](https://cdn.jsdelivr.net/gh/agentwrapper/agent-orchestrator@main/README.md))
- [Worktree Isolation](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agentic-workflows/worktree-isolation.md) — Uses separate git worktrees for each agent session to prevent file system conflicts during parallel development.
- [Programmatic Agent Spawning](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/management-and-discovery/agent-registries/programmatic-agent-spawning.md) — Programmatically spawns new agent sessions for specific issues or prompts with custom plugin configurations. ([source](https://ao-agents.com/docs/cli/))
- [AI Review Loop Management](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-code-reviewers/ai-review-loop-management.md) — Tracks pull request status and CI results to prompt agents to fix tests or address reviewer changes. ([source](https://ao-agents.com/docs/quickstart/))
- [AI Software Engineering](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-software-engineering.md) — Automates the end-to-end development lifecycle from issue tracking and coding to review and merging.
- [Coding Agent Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/artificial-intelligence-tooling/agent-and-tool-integrations/coding-agent-integrations.md) — Integrates AI agents with issue trackers and version control to automate the workflow from ticket to merged pull request.
- [Multi-Repository Orchestration](https://awesome-repositories.com/f/artificial-intelligence-ml/multi-agent-orchestration/multi-repository-orchestration.md) — Provides a unified interface to control and monitor AI agents working across several different code repositories. ([source](https://ao-agents.com/docs/guides/))
- [Parallel Coding Sessions](https://awesome-repositories.com/f/artificial-intelligence-ml/parallel-ai-workflows/parallel-coding-sessions.md) — Spawns multiple AI agents to resolve separate issues simultaneously using isolated worktrees.
- [Agent Plugin Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-plugin-frameworks.md) — Provides a pluggable architecture for swapping LLM models, execution runtimes, and external tool integrations.
- [Agent Runtimes](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-runtimes.md) — Executes agent processes using diverse backends such as tmux or standard system processes. ([source](https://ao-agents.com/docs/platforms/))
- [Agent Prompt Templates](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/configuration-and-specifications/agent-prompt-templates.md) — Allows the injection of project-specific instructions and conventions into agent prompts to enforce coding standards. ([source](https://ao-agents.com/docs/examples/))
- [Batch Agent Spawning](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/management-and-discovery/agent-registries/programmatic-agent-spawning/batch-agent-spawning.md) — Launches multiple agent sessions for a list of issues simultaneously while skipping duplicate or active sessions. ([source](https://ao-agents.com/docs/cli/))
- [Dynamic Model Swapping](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-model-integrations/dynamic-model-swapping.md) — Configures which AI model or plugin performs specific coding tasks and defines their file system permissions. ([source](https://ao-agents.com/docs/examples/))
- [Fix Verification Workflows](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-coding-assistants/issue-comment-responders/fix-verification-workflows.md) — Automatically marks issues as verified or failed after performing staging checks and updating the issue record. ([source](https://ao-agents.com/docs/cli/))
- [Role-Based Model Assignment](https://awesome-repositories.com/f/artificial-intelligence-ml/model-configuration/role-based-model-assignment.md) — Assigns different models to orchestration and execution roles to balance reasoning depth with speed.

### DevOps & Infrastructure

- [CI/CD Automation Servers](https://awesome-repositories.com/f/devops-infrastructure/ci-cd-automation-servers.md) — Functions as an orchestrator that detects CI failures and automatically triggers agents to implement fixes.
- [CI Failure Remediation](https://awesome-repositories.com/f/devops-infrastructure/ci-integrations/ci-failure-remediation.md) — Automatically detects failed CI builds and re-activates AI agents to implement the necessary fixes. ([source](https://ao-agents.com/docs))
- [Agentic Feedback Routing](https://awesome-repositories.com/f/devops-infrastructure/feedback-loops/agentic-feedback-routing.md) — Routes failure reports and review comments directly to agents to trigger autonomous bug fixes. ([source](https://cdn.jsdelivr.net/gh/agentwrapper/agent-orchestrator@main/README.md))
- [Review Comment Synchronization](https://awesome-repositories.com/f/devops-infrastructure/feedback-loops/review-comment-synchronization.md) — Monitors pull request comments for requested changes and automatically prompts the agent to apply fixes. ([source](https://ao-agents.com/docs/))
- [Pull Request Management](https://awesome-repositories.com/f/devops-infrastructure/version-control-management/version-control-workflows/pull-request-management.md) — Coordinates the end-to-end lifecycle of code changes from pull request creation through CI tracking and merging. ([source](https://ao-agents.com/docs/architecture/))
- [Pull Request Status Trackers](https://awesome-repositories.com/f/devops-infrastructure/cicd-pipeline-automation/cicd-pipeline-management/continuous-integration-integrations/pull-request-status-trackers.md) — Provides a visualization of agent-created pull requests including CI status, diff sizes, and review decisions. ([source](https://ao-agents.com/docs/dashboard/))
- [Plugin Extensibility](https://awesome-repositories.com/f/devops-infrastructure/release-automation/plugin-extensibility.md) — Integrates external plugins from packages or local paths to add custom trackers or notification handlers. ([source](https://ao-agents.com/docs/configuration/))

### Development Tools & Productivity

- [Automated Pull Request Reviewers](https://awesome-repositories.com/f/development-tools-productivity/developer-utilities-libraries/developer-tools/version-control-ecosystems/github-integrations/automated-pull-request-reviewers.md) — Automatically scans pull requests for review comments and triggers AI agents to address the feedback. ([source](https://ao-agents.com/docs/cli/))
- [Agent Session Parallelization](https://awesome-repositories.com/f/development-tools-productivity/parallel-execution/custom-parallel-task-execution/parallel-task-orchestrators/agent-session-parallelization.md) — Executes multiple concurrent AI agent coding sessions in isolation to process separate issues simultaneously. ([source](https://ao-agents.com/docs/guides/))
- [Git Workspace Isolations](https://awesome-repositories.com/f/development-tools-productivity/workspace-isolation/git-workspace-isolations.md) — Provides each agent session with its own git worktree to prevent conflicts during parallel development. ([source](https://ao-agents.com/docs/architecture/))
- [Component Configuration](https://awesome-repositories.com/f/development-tools-productivity/component-configuration.md) — Integrates models, runtimes, issue trackers, and notification services through a central modular configuration file. ([source](https://ao-agents.com/docs/))
- [Issue Tracking Integrations](https://awesome-repositories.com/f/development-tools-productivity/issue-tracking-integrations.md) — Integrates the orchestration process with external issue trackers to align automated tasks with project tickets. ([source](https://ao-agents.com/docs/architecture/))
- [Terminal Session Management](https://awesome-repositories.com/f/development-tools-productivity/terminal-automation/terminal-session-management.md) — Manages the lifecycle of agent terminal sessions for real-time interaction via local terminals or a dashboard. ([source](https://ao-agents.com/docs/plugins/))
- [Session Attachment Tools](https://awesome-repositories.com/f/development-tools-productivity/terminal-automation/terminal-session-management/session-attachment-tools.md) — Allows users to connect to running agent sessions through native terminal emulators or a web-based dashboard. ([source](https://ao-agents.com/docs/platforms/))
- [Bidirectional Terminal Interfaces](https://awesome-repositories.com/f/development-tools-productivity/terminal-output-monitors/bidirectional-terminal-interfaces.md) — Implements a live bidirectional terminal interface via WebSockets to monitor agent output and send commands. ([source](https://ao-agents.com/docs/dashboard/))
- [Workflow Automation Triggers](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-triggers.md) — Implements triggers that initiate automated agent actions in response to system events like CI failures or review comments. ([source](https://ao-agents.com/docs/architecture/))

### Software Engineering & Architecture

- [Plugin-Based Architectures](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/plugin-module-systems/modular-plugin-architectures/plugin-based-architectures.md) — Employs a modular architecture allowing the swapping of LLM providers, runtimes, and issue trackers.
- [Agent Configuration Files](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/configuration-formats-and-schemas/yaml-configuration-files/agent-configuration-files.md) — Implements configuration files to define agent roles, runtimes, and isolation strategies. ([source](https://ao-agents.com/docs/configuration/))
- [Multi-Project Task Coordination](https://awesome-repositories.com/f/software-engineering-architecture/distributed-coordination-systems/task-coordinations/multi-project-task-coordination.md) — Links agent activities to external ticket systems and team identifiers across multiple projects. ([source](https://ao-agents.com/docs/examples/))
- [Notification Dispatchers](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/programmatic-interfaces/webhook-event-notifications/webhook-dispatchers/notification-dispatchers.md) — Routes execution alerts to various external services including desktop notifications, chat platforms, and webhooks. ([source](https://ao-agents.com/docs/plugins/))
- [Project Progress Tracking](https://awesome-repositories.com/f/software-engineering-architecture/project-progress-tracking.md) — Monitors software development progress by integrating with issue trackers and version control pull requests. ([source](https://ao-agents.com/docs/plugins/))

### System Administration & Monitoring

- [CI Build Remediation](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/observability-platforms/log-management-systems/ai-powered-log-analyzers/automated-remediation/ci-build-remediation.md) — Monitors CI pipelines and automatically triggers AI agents to fix build failures and regressions.
- [Workflow Management Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/pipeline-monitoring-dashboards/workflow-management-dashboards.md) — Provides a centralized dashboard to launch, monitor, and review the work of multiple agents across repositories. ([source](https://cdn.jsdelivr.net/gh/agentwrapper/agent-orchestrator@main/README.md))
- [Real-Time Event Notifications](https://awesome-repositories.com/f/system-administration-monitoring/alert-event-forwarding/real-time-event-notifications.md) — Sends real-time status updates across multiple transport backends based on event priority. ([source](https://ao-agents.com/docs/architecture/))
- [Internal Telemetry Monitors](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/internal-telemetry-monitors.md) — Captures and exposes internal operational state snapshots as JSON to power a live activity dashboard. ([source](https://ao-agents.com/docs/architecture/))
- [Agent State Telemetry](https://awesome-repositories.com/f/system-administration-monitoring/remote-telemetry-dashboards/agent-state-telemetry.md) — Writes internal component snapshots to disk to power a live dashboard of agent activities and system health.
- [Session Activity Monitors](https://awesome-repositories.com/f/system-administration-monitoring/system-activity-monitoring/session-activity-monitors.md) — Provides an interface for tracking and analyzing active agent development sessions, including branch and CI status. ([source](https://ao-agents.com/docs/cli/))
- [AI Agent Activity Monitors](https://awesome-repositories.com/f/system-administration-monitoring/system-activity-monitoring/session-activity-monitors/ai-agent-activity-monitors.md) — Provides real-time tracking of AI agent tools and sub-agent task progress via a live terminal view. ([source](https://ao-agents.com/docs/quickstart/))
- [Orchestrator Session Management](https://awesome-repositories.com/f/system-administration-monitoring/terminal-session-managers/parallel-session-orchestrators/orchestrator-session-management.md) — Allows selecting between existing orchestrator instances or spawning new sessions to coordinate agent fleets. ([source](https://ao-agents.com/docs/dashboard/))
- [Session Termination](https://awesome-repositories.com/f/system-administration-monitoring/terminal-session-managers/session-termination.md) — Provides commands for shutting down running orchestrator agents and dashboards with options to purge session data. ([source](https://ao-agents.com/docs/cli/))

### Part of an Awesome List

- [Bidirectional Agent Streams](https://awesome-repositories.com/f/awesome-lists/devtools/websockets-and-real-time/bidirectional-agent-streams.md) — Provides bidirectional WebSocket streaming between the orchestrator and agent shells for real-time interaction.

### Business & Productivity Software

- [AI Agent Session Managers](https://awesome-repositories.com/f/business-productivity-software/team-collaboration-management/collaborative-chat-sessions/ai-agent-session-managers.md) — Provides tools to list, attach to, kill, and restore agent sessions and their associated worktrees. ([source](https://ao-agents.com/docs/cli/))

### Networking & Communication

- [Notification Routing Services](https://awesome-repositories.com/f/networking-communication/notification-routing-services.md) — Aggregates and dispatches alerts across multiple channels by mapping alert levels to specific notifier instances. ([source](https://ao-agents.com/docs/configuration/))

### Security & Cryptography

- [Agentic Session Persistence](https://awesome-repositories.com/f/security-cryptography/identity-access-management/session-management/stateful-session-persistence/agentic-session-persistence.md) — Persists active process metadata and workspace states to disk to enable session recovery after reboots.
- [AI Agent Role Assignments](https://awesome-repositories.com/f/security-cryptography/role-based-access-control/workspace-role-assignments/ai-agent-role-assignments.md) — Assigns specific roles such as orchestrator or executor to different LLMs to optimize for reasoning and speed. ([source](https://ao-agents.com/docs/guides/))
- [Agent Execution Environments](https://awesome-repositories.com/f/security-cryptography/secure-execution-environments/agent-execution-environments.md) — Provides the ability to swap between different compute layers like tmux, Docker, or Kubernetes for agent execution. ([source](https://ao-agents.com/docs/architecture/))
- [Per-Session Workspace Isolations](https://awesome-repositories.com/f/security-cryptography/security/policies/access-control/workspace-isolation/per-session-workspace-isolations.md) — Ensures agent session isolation using tmux windows or child processes to prevent cross-task interference. ([source](https://ao-agents.com/docs/plugins/))

### Web Development

- [Development Session Orchestrators](https://awesome-repositories.com/f/web-development/session-orchestration-tools/development-session-orchestrators.md) — Provisions isolated workspaces and launches the orchestrator and web dashboard via local paths or repository URLs. ([source](https://ao-agents.com/docs/cli/))