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.
Two Orchestration Patterns
Every decision is either a debate or a build. AOS handles both.
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.
Strategic Council, Security Review, Architecture Review
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.
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 →The Agents
15 cognitive agents, each with a distinct bias, temperament, and evidence standard.
Arbiter
Synthesize competing perspectives into actionable, ranked recommendations with documented dissent
CTO Orchestrator
Deliver a complete, buildable execution package with minimal ambiguity
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.