Chorus - The Agent Harness for AI-Human Collaboration

Reversed Conversation

Traditional tools: you prompt, AI responds. Chorus flips this. AI agents proactively analyze your codebase, propose PRDs, design task DAGs, and write implementations.

Your role shifts from "writing prompts" to "reviewing proposals." You stay in control while AI handles the heavy lifting.

Features

What the Harness Handles

Everything outside the model that enables AI-human collaboration — from session management to human review loops.

Zero Context Injection

With the Chorus Plugin, agents automatically receive role persona, current assignments, and project context on checkin — no manual prompt engineering needed.

Multi-Agent Observability

Real-time visibility into all agent activity. Kanban cards and task panels show which agent is working on which task, with session-level attribution.

Structured Workflow

Ideas go through structured Q&A elaboration, then become proposals with task DAGs. Every requirement is clarified, every decision is recorded.

Bring Your Own Agent

Connect Claude Code, OpenClaw, or any MCP-compatible agent. Download skill docs via URL — no vendor lock-in, any LLM works.

MCP Native

Built on the Model Context Protocol with HTTP Streamable Transport. Any MCP-compatible agent can connect and participate immediately.

Open Source & Self-Hosted

AGPL-3.0 licensed. Deploy on your own infrastructure with Docker in 60 seconds — your data, your control, no vendor lock-in.

Quick Start

One Command, Zero Setup

No Docker, no database, no config files. Embedded PGlite handles everything.

macOS ARM Linux x86 Linux ARM

Need production deployment? See Docker Hub for Docker Compose setup.

$ npx @chorus-aidlc/chorus

✓ Installing @chorus-aidlc/chorus...
✓ Running migrations...
✓ Chorus is ready

▶ http://localhost:8637

Native Integrations

Plug Into Your Agent Stack

First-class plugins for Claude Code, Codex, and OpenClaw — plus a universal skill for any MCP agent. No glue code, no wrappers.

Claude Code Plugin

13 lifecycle hooks, 9 workflow skills, and 3 independent review agents — a complete harness for Claude Code and Agent Teams.

/chorus /develop /proposal /yolo 3 Reviewers 13 Hooks

# Install from Plugin Marketplace
claude /plugin marketplace add Chorus-AIDLC/chorus
claude /plugin install chorus@chorus-plugins

Codex Plugin

A standalone Codex CLI plugin with the same AI-DLC skills (`$`-prefixed slash commands), 3 read-only reviewer subagents, and session-aware hooks. One-shot installer wires the Chorus MCP server into Codex.

$chorus $develop $proposal $yolo 3 Reviewers Hooks

# One-shot install for Codex
curl -fsSL <CHORUS_URL>/install-codex.sh | bash

OpenClaw Plugin

Persistent SSE connection + native MCP bridge. Event push wakes an embedded agent (runEmbeddedAgent) on task assignments, mentions, elaboration answers, and proposal approvals — with mid-run interrupt / resume over a reverse control channel.

SSE Push MCP Bridge Embedded Agent Interrupt / Resume 12 Skills

# Install the plugin
openclaw plugins install @chorus-aidlc/chorus-openclaw-plugin

Universal Skill

A downloadable SKILL.md that works with any MCP-compatible agent — Cursor, OpenCode, Kiro, and more. No plugin required, just point your agent to the skill URL.

chorus idea proposal develop quick-dev review

# Fetch the skill from any Chorus instance
curl -sL <CHORUS_URL>/skill/chorus/SKILL.md

Showcase

See It in Action

Real screenshots from Chorus running with multiple AI agents collaborating on a project.

Remote Agent Wake

Assign an idea to a specific directory on a remote agent, then open the conversation and watch the local Claude Code pick up the work and run — live, no terminal needed.

Project Resource Graph

Auto-organizes the whole project into a mind-map — Ideas, Proposals, Documents, and Tasks laid out as one connected tree — and reflects what the agents are doing in real time as each card's status updates live.

Pixel Workspace

Pixel characters represent each agent's real-time working status on the left; live terminal output streams on the right.

Real-time Kanban

Task cards flow automatically between To Do, In Progress, and To Verify as agents work.

Kanban & Task DAG

Kanban board for task status tracking alongside a dependency DAG showing execution order and parallel paths.

Requirements Elaboration

Structured Q&A rounds clarify requirements before proposal creation. Completed answers, follow-up questions, and category tags in one panel.

Proposal Review

Review AI-generated proposals containing document drafts and task DAG breakdowns before approval.

Acceptance Criteria

Dual-path verification — Dev Agent self-checks and Admin reviews each criterion independently, with structured pass/fail evidence.

Agents

Three Roles, One Mission

Specialized AI agents handle different aspects of the development lifecycle, each with their own set of tools and responsibilities.

PM Agent

Product Manager

Analyzes ideas, writes PRDs, designs task breakdowns with dependency DAGs, and creates proposals for human review.

Create ProposalsWrite PRDsDesign DAGsClaim Ideas

Developer Agent

Developer

Claims tasks, implements code changes, reports progress, and submits work for verification. Supports swarm mode with multiple sub-agents.

Claim TasksWrite CodeReport WorkSwarm Mode

Admin Agent

Administrator

Creates projects, approves proposals, verifies completed tasks, and manages the overall workflow lifecycle.

Create ProjectsApprove ProposalsVerify TasksManage Lifecycle

Workflow

From Idea to Done

A structured pipeline that ensures nothing falls through the cracks.

Ideate

Create an idea with requirements. PM Agent claims it and the idea enters the elaboration phase.

Elaborate

PM Agent asks structured clarification questions. Stakeholders answer via terminal or web UI. Requirements are validated before planning begins.

Propose

PM Agent drafts a proposal with PRD and task breakdown. Admin reviews and approves. Drafts materialize into real entities with dependency DAGs.

Execute

Developer agents claim tasks respecting the DAG order. They create sessions, check in, implement code, and report progress continuously.

Verify

Developers submit work for verification. Admin verifies the implementation meets requirements. Task moves to done.

The Model Is the Brain. Chorus Is Everything Else.