Agentic Orchestration System

A config-driven framework that assembles specialized AI agents into deliberation councils and execution teams on top of Claude Code, Codex, Gemini, and Pi.

$ bun add aos-harness
$ bunx aos run strategic-council

# local install or global CLI. 15 agents. 8 profiles.

15
Agents
8
Profiles
5
Domains
5
Skills

Two Orchestration Patterns

Every decision is either a debate or a build. AOS handles both.

deliberation

Deliberation

A neutral Arbiter frames the question. Specialist agents debate from opposing perspectives. The Provocateur stress-tests consensus. Output: a structured memo with ranked recommendations and documented dissent.

Brief Arbiter Broadcast Tension Pairs Provocateur Memo

Strategic Council, Security Review, Architecture Review

execution

Execution

A CTO Orchestrator drives the product lifecycle. Agents produce artifacts in sequence — requirements, architecture, planning, tasks, security review, and final assembly. Output: a complete execution package ready for engineering handoff.

Brief CTO Requirements Architecture Tasks Package

CTO Execution Orchestration

Goes further with Dev Execution

Dev Execution goes beyond planning to actual code implementation. An Engineering Lead spawns domain-scoped worker agents that write code directly to your working directory via hierarchical delegation — from brief to committed-ready changes in a single session.

Learn about Dev Execution →

Supported CLIs

Bring the AI CLI you already use. Install the matching adapter, then optionally add the host-native surface for that runtime.

Pi CLI

Keep Pi installed, add the Pi adapter, and run the same AOS profiles through the Pi extension package.

$ npm i -g @aos-harness/pi-adapter

Claude Code

Use your existing Claude Code installation, add the adapter, then optionally install the project command pack.

$ npm i -g @aos-harness/claude-code-adapter
$ bash plugins/aos-harness/claude-code/install.sh

Codex CLI

Pair Codex CLI with the Codex adapter, then optionally install the local Codex plugin bundle on top.

$ npm i -g @aos-harness/codex-adapter
$ aos init --apply

Gemini CLI

Run the same deliberation and execution profiles through Gemini after installing the matching adapter package.

$ npm i -g @aos-harness/gemini-adapter

Ready to orchestrate?

Install the framework. Write a brief. Let 15 agents debate your hardest question.