Agent Orchestra

Multi-agent runtime for code review, automation, and orchestrated AI workflows.

Install

npm install -g @malayvuong/agent-orchestra

Requires Node.js >= 20. The CLI command is ao.

Quick Start

ao setup                  # interactive wizard — provider, config, automation, dashboard

Or minimal setup:

ao init                   # auto-detect and configure

Review a file

ao run --target ./docs/spec.md --superpower plan-review --auto-apply

The architect analyzes, the reviewer challenges, they debate, acknowledged findings get patched. See results:

ao job list
ao job show <job-id>

Automate workflows

ao automation add ./jobs/nightly.json     # register a job
ao automation run nightly                 # run immediately
ao automation logs nightly                # see run history

Dashboard

ao daemon start           # start in background → http://localhost:3100/
ao daemon status           # check if running
ao daemon stop             # stop

The dashboard lets you manage runs, tasks, automation jobs, sessions, and projects through a web UI.

Manage projects

ao project list            # all registered projects across your machine
ao project add             # register current directory
ao project status          # detailed status + data counts

Superpowers

Ready-to-use review presets:

Superpower	Best for
plan-review	specs, plans, RFCs
security-review	code security, OWASP
test-generation	missing tests and edge cases
dependency-audit	package risk

Providers

ao init auto-detects available providers:

Provider	Default model
claude-cli	claude-opus-4-6
codex-cli	gpt-5.4
openai	gpt-5.4
anthropic	claude-sonnet-4-6

Override per run:

ao run --target ./spec.md --architect-provider claude-cli --reviewer-provider codex-cli

Documentation

Guides

• Setup Guide — interactive wizard walkthrough
• Automation Guide — create and manage workflow jobs
• Dashboard & Daemon — web UI, REST API, daemon management
• Project Manager — multi-project tracking
• CLI Reference — all commands at a glance

Architecture

• Architecture Overview — system layers, key concepts, design principles
• Implementation Plan — detailed phase breakdown

Reference

• Quick Start with Init
• Superpowers Overview
• Built-in Superpowers
• Plan Review
• MCP Integration
• Skill Format Reference

Development

If you are developing Agent Orchestra itself and want to run this checkout instead of the npm package:

git clone https://github.com/malayvuong/agent-orchestra.git
cd agent-orchestra
pnpm install
pnpm link:ao
ao --help

This creates a symlink in the npm global bin directory so ao resolves to the local checkout.

Remove the local link later with pnpm unlink:ao.

Links

• GitHub: https://github.com/malayvuong/agent-orchestra
• Issues: https://github.com/malayvuong/agent-orchestra/issues

License

MIT