Chorus

The harness for your coding agents. Agents propose, humans verify, software ships.

English · 中文 · 한국어 · 日本語

📖 Documentation

Chorus is the harness for your coding agents. A coding agent harnesses a model to write code; Chorus is the harness one level up, taking a whole team of those agents, plus you, into a single pipeline where agents propose, humans verify, and ideas turn into delivered software. Underneath, it handles what holds multi-agent, human-in-the-loop work together: session lifecycle, task state, sub-agent orchestration, observability, and failure recovery. Every AI Agent gets fine-grained, configurable permissions.

Inspired by the AI-DLC (AI-Driven Development Lifecycle) methodology. Core philosophy: Reversed Conversation — AI proposes, humans verify.

---

AI-DLC Workflow

Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Verify ──> Done
  ^          ^               ^                     ^          ^         ^
Human     idea:write     proposal:write         task:write   *:admin    *:admin
creates   + elaborate    + drafts                + reports   + verifies + closes

The labels under each stage are the permissions an actor needs there — granted to a human, an Agent, or both. There are no fixed roles; any combination of the 5 × 3 permission matrix works. → Agent permissions

---

What's New

v0.23.0: Manage workspace-local accounts and personalize display names and avatars. Adds proposal dependency validation, optional Pi pre-submit checks, and shared Redis auth rate limits; fixes task actor attribution and duplicate mention notifications.

v0.22.2: Host Chorus on your own Linux or macOS machine with Docker Compose and PostgreSQL 17, with repeatable deployment, optional LAN HTTPS, and Cloudflare Tunnel guidance. TRAE CLI joins the existing workflow through the shared Codex plugin. This release also fixes stale assignments, deletion failures, and daemon security and configuration issues.

v0.22.0: Hermes Agent now joins the existing Chorus workflow through its own gateway, with no separate Chorus daemon. Assign work in Chorus, run it in Hermes, and bring results and approval requests back to the project. Install through the Chorus CLI or directly with Hermes.

v0.21.0: Private projects and project groups provide Viewer, Editor, and Admin access with live permission inheritance. Agent startup and execution failures now include persistent diagnostics in conversations. This release also improves Linux daemon persistence and updates security dependencies.

v0.20.0 — Daemon backends now use Codex App Server, bidirectional Claude Code stream-json, and native Pi RPC for protocol-based interruption and execution tracking. New chorus upgrade updates npm-global CLI installations; --plugins also refreshes configured Claude Code, Codex, Kiro, and Pi integrations.

v0.19.1 — Lightweight Research checks factual gaps during Idea and Proposal preparation. Inline evidence citations put sources next to claims, and Tracker can request more research before development starts.

v0.19.0 — Cloudflare-inspired reviewer rules: clearer scope, complete blocker evidence, and stable finding IDs across rounds. Task reviews now check code quality beyond acceptance criteria.

v0.18.0 — Built-in spec-lite adds a lightweight, Git-native local spec workflow alongside OpenSpec. Live session anchors let daemon agents return replies to the initiating agent's existing Idea session.

v0.17.2 — Pi is now a published, wakeable Chorus agent, and chorus agents run switches local agent profiles with one command.

v0.17.0–0.17.1 — One CLI now installs and refreshes Chorus across your coding agents. Live daemon activity is visible directly on Ideas in Tracker, Graph, and detail views.

Full changelog: CHANGELOG.md

---

Quick Start

Two commands. No database, no Docker, no config files.

npm install -g @chorus-aidlc/chorus@0.21.0
chorus

Chorus starts with an embedded PostgreSQL (PGlite), runs migrations, and opens at http://localhost:8637. Default login: admin@chorus.local / chorus.

Running multiple agents or deploying to production? Use an external PostgreSQL, Docker, or AWS → Deploy & self-host.

Hosting on your own machine or connecting a Cloudflare Tunnel? See Self-host on a local machine for installation, LAN HTTPS, and Cloudflare Named Tunnel setup.

To turn your local machine into an agent runtime that picks up assigned tasks, run chorus daemon → Daemon operations · Remote control.

Upgrade the CLI and plugins

chorus upgrade             # CLI only; `chorus update` is an alias
chorus upgrade --plugins   # Also refresh configured agents' Chorus plugins

Self-upgrade supports the active npm global installation on Linux, macOS and Windows. It checks npm's prefix, resolves the latest stable release, avoids downgrades and verifies the installed version. Source checkouts, links, npx and other package-manager