The Agent Harness for AI-Human Collaboration — session lifecycle, task state, sub-agent orchestration, observability, and failure recovery
$git clone https://github.com/chorus-aidlc/chorusInstalls into the current project.
Install chorus by running `git clone https://github.com/chorus-aidlc/chorus`, then use it for the current task and follow its documentation at https://github.com/chorus-aidlc/chorus.
| 1 | <p align="center"> |
| 2 | <img src="packages/landing/public/images/chorus-slug.png" alt="Chorus" width="240" /> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"><strong>The Agent Harness for AI-Human Collaboration</strong></p> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <a href="https://discord.gg/SwcCMaMmR"> |
| 9 | <img src="https://img.shields.io/badge/Discord-Join%20us-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"> |
| 10 | </a> |
| 11 | <a href="https://github.com/Chorus-AIDLC/Chorus/actions/workflows/test.yml"> |
| 12 | <img src="https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/ChenNima/f245ebf1cf02d5f6e3df389f836a072a/raw/coverage-badge.json" alt="Coverage"> |
| 13 | </a> |
| 14 | </p> |
| 15 | |
| 16 | <p align="center"><strong>English</strong> · <a href="README.zh.md">中文</a> · <a href="README.ko.md">한국어</a> · <a href="README.ja.md">日本語</a></p> |
| 17 | |
| 18 | Chorus is an agent harness — the infrastructure that wraps around LLM agents to manage session lifecycle, task state, sub-agent orchestration, observability, and failure recovery. It lets multiple AI Agents (with fine-grained, configurable permissions) and humans collaborate through the full workflow from requirements to delivery. |
| 19 | |
| 20 | Inspired by the **[AI-DLC (AI-Driven Development Lifecycle)](https://aws.amazon.com/blogs/devops/ai-driven-development-life-cycle/)** methodology. Core philosophy: **Reversed Conversation** — AI proposes, humans verify. |
| 21 | |
| 22 | --- |
| 23 | |
| 24 | ## AI-DLC Workflow |
| 25 | |
| 26 | ``` |
| 27 | Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Verify ──> Done |
| 28 | ^ ^ ^ ^ ^ ^ |
| 29 | Human idea:write proposal:write task:write *:admin *:admin |
| 30 | creates + elaborate + drafts + reports + verifies + closes |
| 31 | ``` |
| 32 | |
| 33 | The labels under each stage are the **permissions** an actor needs at that stage — granted to a human, an Agent (preset or Custom), or both. There are no fixed roles; any combination of the 5 × 3 permission matrix is possible. See [`docs/PERMISSIONS.md`](docs/PERMISSIONS.md). |
| 34 | |
| 35 | --- |
| 36 | |
| 37 | ## What's New |
| 38 | |
| 39 | **[v0.14.1](https://chorus-ai.dev/blog/chorus-v0.14.1-release/)** — Amazon Kiro CLI is the fourth way to connect (Kiro CLI v2): a one-command `install-kiro.sh` plugin and a `--agent kiro` daemon backend, plus daemon fixes. |
| 40 | |
| 41 | **[v0.14.0](https://chorus-ai.dev/blog/chorus-v0.14.0-release/)** — Dark mode across the app (light / dark / system). Reference artifacts: attach docs, repos, issues, and articles to any idea, proposal, or task, readable inline and over MCP. Korean and Japanese locales (Korean contributed by the community). **Theme** ideas for grouping, plus daemon Start Development / Yolo buttons, conversational idea entry, crash-resume, and `chorus daemon install`. |
| 42 | |
| 43 | **[v0.13.0](https://chorus-ai.dev/blog/chorus-v0.13.0-release/)** — Per-project resource mind-map: a new Graph view wires each project's Ideas, Proposals, Documents, and Tasks into one collapsible tree, generated from the project's own structure. Every card carries its current status (ideas show the derived pipeline status the idea tracker uses), a title search auto-expands the path to every match with highlight/dim and prev/next navigation, and the same zoom/pan canvas renders on desktop and mobile (pinch + double-tap). |
| 44 | |
| 45 | **[v0.12.0](https://chorus-ai.dev/blog/chorus-v0.12.0-release/)** — Addressable daemon instances: one `chorus daemon` can serve multiple working directories (`--cwd`), and each `(agent, host, cwd)` becomes an individually visible, individually targetable instance across presence, @-mention, and assignment. Pin an instance once on an idea and its proposals, tasks, and wakes inherit it; pinned wakes are delivered to exactly that instance instead of broadcast. Comment @-mentions render as live online-status badges, and comments switch to cursor-based infinite scroll. |
| 46 | |
| 47 | **[v0.11.0](https://chorus-ai.dev/blog/chorus-v0.11.0-release/)** — The Chorus Daemon: `chorus daemon` turns your machine into a resident agent runtime that wakes a local Claude Code on each dispatch. An Agent Connect |