gitwtfhub

wtf is agent-orchestration-harness?

submerge12/agent-orchestration-harness — explained in plain English

Analysis updated 2026-05-18

21JavaScriptAudience · developerComplexity · 3/5Setup · easy

TL;DR

AOH is a governance layer that runs AI coding agents like Codex or Claude Code as structured, reviewable, human-gated workflows.

Mindmap

mindmap
  root((AOH))
    What it does
      Structures tasks
      Runs multiple agents
      Enforces governance
      Reviews evidence
    Tech stack
      JavaScript
      Node.js
    Use cases
      Multi-agent workflows
      Permission enforcement
      Human approval gates
      Workflow replay
    Audience
      Developers
      AI agent teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Break a coding task into a dependency-aware workflow run by interchangeable AI agents.

REASON 2

Enforce permission limits, budgets, and workspace isolation while agents execute a task.

REASON 3

Require independent review of an agent's real diffs and evidence before accepting its work.

REASON 4

Replay a workflow's full history from append-only records to audit what an agent did.

What's in the stack?

JavaScriptNode.js

How it stacks up

submerge12/agent-orchestration-harnessahmedabdodev/fcis-gpa-helperamazingsyp/pokemon-ontology
Stars212121
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity3/52/53/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Requires Node.js 22 or later, using it fully also requires access to executor agents like Codex or Claude Code.

Wtf does this do

Agent Orchestration Harness, or AOH, is a system for running AI coding agents in a way that stays visible and controllable rather than letting them work unsupervised. Instead of just firing off a prompt and hoping for a good result, it turns a piece of work into a structured task with clear acceptance criteria, breaks that task into smaller steps that depend on each other, and hands each step to an interchangeable agent such as PI Agent, Codex, or Claude Code through one shared interface. As the agents work, AOH enforces limits on what they are allowed to touch, keeps their workspaces separate from each other, tracks how much budget they are using, and pauses for a human decision at points that matter rather than every small action. When a step is claimed finished, the system checks the real changes and evidence the agent produced instead of just trusting its report, and an independent review decides whether to accept the work, ask for repairs, block it, or escalate it to a person. All of this activity is recorded in an append only history so the whole process can be replayed later, and a dashboard called the Control Room lets you inspect projects, tasks, blockers, evidence, and decisions. Getting started requires Node.js 22 or newer, after which you install dependencies and run the included type checks and test suite. The project states plainly which parts are working today, such as the governance rules, the agent adapters, and the review flow, and which features, like natural language task dispatch or long running resumable sessions, are not yet shipped. The README does not state a specific license, only that license terms are defined somewhere in the repository.

Yoink these prompts

Prompt 1
Explain how AOH turns a task into a dependency-aware multi-agent workflow.
Prompt 2
Walk me through installing AOH and running its type checks and test suite.
Prompt 3
What happens when an agent claims a step is finished but the evidence review rejects it?
Prompt 4
How does the Control Room let me inspect tasks, blockers, and pending human decisions?

Frequently asked questions

wtf is agent-orchestration-harness?

AOH is a governance layer that runs AI coding agents like Codex or Claude Code as structured, reviewable, human-gated workflows.

What language is agent-orchestration-harness written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js.

How hard is agent-orchestration-harness to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is agent-orchestration-harness for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.