agent-orchestrator README

The project's README from github.com/OrchestratorInc/agent-orchestrator. As one markdown file: README.md.

Agent Orchestrator

Agent Orchestrator

Plan, run, and supervise coding agents from one place.

GitHub stars Top 6k repositories GitHub release GitHub downloads License: Apache-2.0 X Discord

Give every coding task its own agent, workspace, and feedback loop.
Plan and delegate larger outcomes with a project-aware orchestrator.
Follow every worker, pull request, CI run, and review in a live Kanban.

Download AO  •  Documentation  •  Releases  •  Contributing  •  Discord

English · 简体中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português (Brasil)


Agent Orchestrator Kanban showing worker sessions grouped by live status

A workspace for agent-driven development

One coding agent can handle a task. Running several across a project creates a different job: deciding what matters, splitting work cleanly, giving each agent the right context, preventing branch collisions, and following every change through review and merge.

AO is a local desktop workspace built for that job. Add a repository and create a worker session with the coding agent, model, and interface that fit the task. For Git-backed work, AO gives the worker its own branch and worktree. The task, conversation, terminal, changed files, browser preview, pull request, CI, and review state stay attached to that session from start to finish.

Behind the desktop app, AO's local daemon watches agent activity and source-control state. The result is a shared, live view of the project instead of a collection of disconnected terminals, branches, and browser tabs.

Install

Download the latest AO desktop app for your platform. AO checks for updates automatically.

Platform Download
macOS (Apple silicon) Download
macOS (Intel) Download
Windows Download
Linux (AppImage) Download
Linux (Debian/Ubuntu) Download
Linux (Fedora/RHEL) Download

Open Agent Orchestrator and point it at the repository you want AO to manage. The desktop app runs the daemon for you, so no CLI is required. See the installation guide for agent CLI setup and troubleshooting.

Agent Orchestrator workspace showing a coding agent's native terminal UI

Workers execute focused tasks

A worker is AO's unit of execution: one task, one coding agent, and one isolated workspace. Use New task when the work is already clear. Describe the outcome, choose an agent and model, attach relevant files, and work with the agent in structured Chat or its native terminal UI.

Open a worker at any time to continue the conversation, attach to its terminal, inspect its changes, use its isolated browser, review its pull request, or send CI and review feedback back to the same agent. This makes each task independently understandable and keeps parallel work from collapsing into one shared context.

Create a new task in Agent Orchestrator with an agent and model selected

The orchestrator plans across the project

The project orchestrator is AO's persistent planning and coordination agent. It works at the level above individual tasks: the product direction, technical strategy, priorities, and sequence of work across the repository.

Use the orchestrator to explore an idea before implementation, brainstorm product and technical approaches, reason through tradeoffs, identify high-impact work, and turn an ambiguous outcome into a concrete plan. Its project-scoped conversation preserves goals, decisions, constraints, and earlier reasoning. It combines that planning history with repository context and live AO state, including active workers, ownership, pull requests, CI, and reviews. This keeps planning grounded in both the project and the work already underway.

When a plan becomes actionable, the orchestrator can break it into focused tasks, spawn or redirect workers, pass each worker the relevant context, follow their progress, and coordinate follow-up work. The orchestrator owns planning and delegation; workers own implementation, tests, commits, and pull requests.

Agent Orchestrator coordinating multiple workers and passing them focused project context

The Kanban keeps the system legible

Every worker appears on the same live board, whether you started it from New task or the orchestrator delegated it. AO derives each card's position from session, pull request, CI, and review facts, turning the Kanban into an operational view of the project:

Each card keeps the task, agent, branch, activity, pull request, and status together. Open it to inspect the conversation or terminal, changed files, PR summary, reviews, and preview. The board shows what is moving, what is blocked, and where your attention will have the most impact.

Agent Orchestrator Kanban showing worker sessions grouped by live status

One workflow, from idea to merge

  1. Start at the right level. Give a clear task directly to a worker, or develop a larger outcome with the project orchestrator and let it shape the plan.
  2. Delegate focused work. Start workers yourself or have the orchestrator create them with the context and ownership they need.
  3. Build in isolation. Every Git-backed worker gets its own branch and worktree; Scratch workers get AO-managed branchless directories.
  4. Supervise live state. AO follows agent activity, pull requests, CI, review feedback, and merge conflicts, then reflects those facts on the Kanban.
  5. Close the feedback loop. Inspect any worker directly, make project-level decisions with the orchestrator, and return actionable failures or review comments to the agent that owns the work.

AO works with the coding agents and source-control workflow you already use. Agents keep their native strengths; AO supplies the project context, isolated execution, coordination, and operational view that make them work as a system.

Product highlights

Pull requests and agent reviews

Keep CI, mergeability, reviewer state, and interactive agent reviews beside the worker, then return requested changes to the same owner.

Worker session with pull request, CI, and agent review state in Agent Orchestrator

Agent-controllable browser

Preview and inspect a worker's local app beside its interface. Browser profiles are isolated per worker so parallel UI tasks do not share state.

A worker controlling its isolated in-app browser preview

Native interfaces, one supervisor

Use structured Chat or the agent's native terminal UI while AO keeps task context, workspace state, and feedback in one place.

Agent terminal interface supervised inside Agent Orchestrator

Supported agents

27 coding agents supported through one supervised workflow.

Claude Code   Claude Code Codex   Codex Cursor   Cursor
opencode   opencode Aider   Aider GitHub Copilot   GitHub Copilot
Grok   Grok Kimi   Kimi Pi   Pi
Amp   Amp Auggie   Auggie Droid   Droid
Crush   Crush Cline   Cline Goose   Goose
Qwen   Qwen Continue   Continue Devin   Devin
Kiro   Kiro Kilo Code   Kilo Code Vibe   Vibe
Muse   Muse Agy   Agy Autohand Autohand
Kimchi   Kimchi Prime Agent   Prime Agent OMP   OMP

Browse agent setup guides →

Use the interface that fits the moment: structured Chat or the agent's native terminal UI.

Report a bug

The recommended way to report a bug is to ask your coding agent to follow the repository's bug-triage skill. It guides the agent through reproducing the problem on current code, gathering diagnostics, tracing the relevant code path, checking for duplicates, and filing or updating a detailed GitHub issue.

Whether you ask a local coding agent or AO Bot on Discord, attach screenshots and share as much relevant context as possible. Include what happened, where and when it happened, steps to reproduce it, your OS and AO version, and whether the problem is consistent or intermittent. This gives the agent the best chance of reproducing the bug and filing an actionable report.

Read and follow https://github.com/Untrivial-ai/agent-orchestrator/blob/main/.agents/skills/bug-triage/SKILL.md. Please reproduce and triage this bug, then file or update the GitHub issue. Context: <what happened, where, when, reproduction steps, OS, AO version, and frequency>. Screenshots: <attach any screenshots>.

You can also report a bug in the bug-triaging channel on Discord. Tag @AO Bot#8425, describe what happened, and ask it to use the bug-triage skill.

@AO Bot#8425 Please reproduce and triage this bug using the bug-triage skill, then file or update the GitHub issue. Context: <what happened, where, when, reproduction steps, OS, AO version, and frequency>. Screenshots: <attach any screenshots>.

Develop and contribute

Contributions are welcome across code, docs, triage, examples, and tests.

git clone https://github.com/Untrivial-ai/agent-orchestrator.git
cd agent-orchestrator

Start with the development guide for prerequisites, local setup, and test commands. Read CONTRIBUTING.md before opening a pull request, and use GitHub Issues for bugs and feature requests.

Documentation

Document Start here when you need
Product documentation Installation, agent setup, and day-to-day product usage.
docs/architecture.md Backend mental model, lifecycle, persistence, CDC, status derivation, and daemon boundaries.
docs/backend-code-structure.md Package ownership and where each backend concern belongs.
docs/cli/README.md CLI behavior and daemon route mapping.
docs/development.md Prerequisites, build steps, running tests, and troubleshooting for local development.
docs/STATUS.md What currently ships on main and what remains in flight.

Follow the journey

Agent Orchestrator journey update on X Agent Orchestrator journey update on X

Community

Join Discord for help and contributor discussion, follow @aoagents for updates, or start a conversation in GitHub Issues.

Anonymous telemetry

AO uses privacy-preserving product usage and reliability metrics designed to exclude PII and project content. These metrics help us understand adoption and improve the product. To und

agent-orchestrator (OrchestratorInc/agent-orchestrator)

Searching Database…

这是什么?Agent Orchestrator(AO)是一个本地桌面工作台,用于规划、运行和监督多个编码智能体团队,覆盖整个软件项目,从第一个任务一直到合并的拉取请求。
AO 本身是编码智能体,还是只负责管理我已经在用的智能体?AO 不自己写代码,它是一个监督应用,会在相互隔离的工作会话中运行外部编码智能体命令行工具(Claude Code、Codex、Cursor、Aider 以及另外 24 个),每个会话都有自己的分支、终端和聊天窗口。
怎样让它运行起来?下载适用于你操作系统的桌面版本(macOS Apple Silicon/Intel、Windows 或 Linux AppImage/Deb/Fedora),打开后指定你想让它管理的代码仓库;应用会自动启动它的本地后台守护进程。
我需要自己安装底层的编码智能体命令行工具吗?需要。AO 监督的是你单独安装好的智能体,例如 Claude Code 或 Codex;安装指南中有智能体命令行工具的设置和故障排查说明。
如果代码仓库不是基于 Git 的,会发生什么?基于 Git 的任务会为每个工作智能体分配独立的分支和工作树,以实现隔离;非 Git 的工作则会改用 AO 管理的、无分支的 'Scratch' 工作智能体,而不是真正的分支。
AO 会把我的代码或项目数据发送到别处吗?AO 只收集匿名的产品使用和稳定性指标;其设计明确排除了个人身份信息(PII)和项目内容。
项目编排器和工作智能体有什么不同?项目编排器在项目层面进行规划,保持一段关于目标、策略和持续工作的长期对话,然后把计划拆分为任务,并派生或重新指派工作智能体。相比之下,每个工作智能体各自负责一项任务、一个智能体,以及一个用于实现的独立分支。
看板上会显示什么?每个工作智能体都会以卡片形式出现在 'Working'、'Needs you'、'In review' 或 'Ready to merge' 列中,列的归属根据会话、拉取请求、CI 和审查状态自动得出,而不是手动设置。
我可以在几个编码智能体之间切换?AO 通过一套受监督的工作流支持 27 种编码智能体,包括 Claude Code、Codex、Cursor、Aider、GitHub Copilot、Grok、Devin 和 Kiro。
我能否在 AO 内预览工作智能体对应用的修改?可以。每个工作智能体都有自己可由智能体控制的浏览器,并拥有独立的配置文件,因此你可以预览本地应用,也可以同时运行多个界面并行任务,而它们之间不会共享状态。
Size
453 MB
Stars
13.3K
Age
8mo
Commits · 90 Days