Chorus-AIDLC/Chorus

Chorus – 编码代理的驾驭工具

一句话描述：一个平台，将多个 AI 编码代理与人工审查者协调在一起，将想法转化为已发布的软件。

功能

• 实现 AI-DLC（AI 驱动的开发生命周期）工作流：想法 → 提案 → 任务 DAG → 执行 → 验证 → 完成。
• 提供 Web UI（Next.js 15， React 19），您可以在其中创建想法、查看实时项目图、看板并监控代理活动。
• 管理 会话生命周期、任务状态、子代理编排、可观测性和故障恢复。
• 提供细粒度的 权限矩阵（5 个阶段 × 3 个角色），可以分配给人类、代理或两者。
• 通过 MCP SDK 支持多种代理后端（Claude Code、Codex、TRAE CLI、Kiro、Pi、Hermes 等）。
• 包含一个 守护进程，在机器上运行，拾取分配的任务并报告结果，无需手动终端操作。
• 自托管选项：使用嵌入式 PostgreSQL（PGlite）单命令安装，或通过 Docker Compose、外部 PostgreSQL 17、可选的局域网 HTTPS 和 Cloudflare Tunnel 进行完整生产部署。

关键组件

组件	技术
前端	Next.js 15, React 19, Tailwind, shadcn/ui
后端	TypeScript 5, Prisma 7, PostgreSQL 17, 可选 Redis
代理集成	MCP SDK（HTTP 流式传输）
认证	OIDC + PKCE, API 密钥, SuperAdmin
CLI	@chorus-aidlc/chorus（npm 全局）– 安装、运行守护进程、升级插件

典型工作流

1. 人类创建 想法。
2. AI 代理起草 提案（PRD + 任务 DAG）。
3. 分配任务；代理执行代码，同时 UI 显示实时状态。
4. 人类验证结果；一旦批准，工作流结束。

快速入门

npm install -g @chorus-aidlc/chorus@0.21.0
chorus   # 在 http://localhost:8637 启动 UI（admin@chorus.local / chorus）

• 演示不需要外部数据库；嵌入式 PostgreSQL 会自动运行。
• 生产环境：请遵循 部署与自托管 指南（Docker Compose、外部 PostgreSQL、Cloudflare Tunnel）。

扩展 / 连接代理

• 使用应用内向导或文档生成 API 密钥（cho_…）。
• 支持的代理包括 Claude Code、Codex、TRAE CLI、Kiro、Pi、Hermes、OpenCode、OpenClaw 以及任何兼容 MCP 的工具。
• chorus daemon 在远程机器上运行；它监视分配的目录并自动执行任务。

适用人群

• 产品团队，希望在人工监督下使用 AI 生成的规格和代码。
• DevOps / 平台工程师，希望在 CI/CD 管道中运行 AI 代理。
• 研究人员，正在实验多代理协调和人工参与的工作流。

许可证

• AGPL-3.0（参见 LICENSE.txt）。

---

文档：https://doc.chorus-ai.dev
Discord 社区：https://discord.gg/SwcCMaMmR