# Agent Orchestra

> Structured multi-agent review for plans, specs, and code with iterative debate, patch-based auto-apply, and a full audit trail.

- **Type:** MCP server
- **Install:** `agentstack add mcp-malayvuong-agent-orchestra`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [malayvuong](https://agentstack.voostack.com/s/malayvuong)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [malayvuong](https://github.com/malayvuong)
- **Source:** https://github.com/malayvuong/agent-orchestra
- **Website:** https://github.com/malayvuong/agent-orchestra

## Install

```sh
agentstack add mcp-malayvuong-agent-orchestra
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Agent Orchestra

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

## Install

```bash
npm install -g @malayvuong/agent-orchestra
```

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

## Quick Start

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

Or minimal setup:

```bash
ao init                   # auto-detect and configure
```

## Review a file

```bash
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:

```bash
ao job list
ao job show 
```

## Automate workflows

```bash
ao automation add ./jobs/nightly.json     # register a job
ao automation enable nightly              # enable scheduled execution
ao automation run nightly                 # run immediately
ao automation logs nightly                # see run history
```

Scheduled jobs run while the daemon/server is running. Schedules use simple intervals like `every 5m`, `every 1h`, or `every 1d`; cron expressions are not supported yet.

## Dashboard

```bash
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

```bash
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 |

## Validate skills

Validate one skill directory:

```bash
ao skills validate 
```

Validate all skills discoverable from a workspace:

```bash
ao skills validate .
```

## 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:

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

## Documentation

### Guides

- [Setup Guide](docs/guides/setup.md) — interactive wizard walkthrough
- [Automation Guide](docs/guides/automation.md) — create and manage workflow jobs
- [Dashboard & Daemon](docs/guides/dashboard.md) — web UI, REST API, daemon management
- [Project Manager](docs/guides/project-manager.md) — multi-project tracking
- [CLI Reference](docs/guides/cli-reference.md) — all commands at a glance

### Architecture

- [Architecture Overview](docs/architecture-overview.md) — system layers, key concepts, design principles
- [Implementation Plan](docs/implementation-plan-v2.md) — detailed phase breakdown

### Reference

- [Quick Start with Init](docs/onboarding/init.md)
- [Superpowers Overview](docs/superpowers/overview.md)
- [Built-in Superpowers](docs/superpowers/builtin-superpowers.md)
- [Plan Review](docs/superpowers/plan-review.md)
- [MCP Integration](docs/integrations/mcp.md)
- [Skill Format Reference](docs/skills/skill-format.md)

## Development

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

```bash
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`.

Before pushing changes, run the same local checks covered by CI:

```bash
pnpm format:check
pnpm lint
pnpm typecheck
pnpm build
pnpm test
pnpm audit --audit-level moderate
```

CI verifies the main matrix on Node.js 20 and 22.

Run the dashboard/API server from this checkout:

```bash
pnpm dev:server
```

## Links

- GitHub: 
- Issues: 

## License

[MIT](LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [malayvuong](https://github.com/malayvuong)
- **Source:** [malayvuong/agent-orchestra](https://github.com/malayvuong/agent-orchestra)
- **License:** MIT
- **Homepage:** https://github.com/malayvuong/agent-orchestra

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-malayvuong-agent-orchestra
- Seller: https://agentstack.voostack.com/s/malayvuong
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.