Chorus-AIDLC/Chorus

Chorus – 코딩 에이전트를 위한 오케스트레이션 하네스

한 줄 설명: 여러 AI 코딩 에이전트와 인간 검토자를 함께 오케스트레이션하여 아이디어를 배포 가능한 소프트웨어로 전환하는 플랫폼입니다.

기능

• AI‑DLC(AI 기반 개발 수명주기) 워크플로우 구현: 아이디어 → 제안 → 작업 DAG → 실행 → 검증 → 완료.
• 웹 UI(Next.js 15, React 19) 제공: 아이디어 생성, 실시간 프로젝트 그래프, 칸반 보드, 에이전트 활동 모니터링 가능.
• 세션 수명주기, 작업 상태, 하위 에이전트 오케스트레이션, 관찰 가능성, 실패 복구 관리.
• 세분화된 권한 매트릭스(5단계 × 3역할) 제공: 인간, 에이전트 또는 둘 다에 할당 가능.
• MCP SDK를 통한 다양한 에이전트 백엔드 지원(Claude Code, Codex, TRAE CLI, Kiro, Pi, Hermes 등).
• 머신에서 실행되는 데몬 포함: 할당된 작업을 가져와 수동 터미널 작업 없이 보고.
• 셀프 호스팅 옵션: 임베디드 PostgreSQL(PGlite) 포함 단일 명령 설치 또는 Docker Compose, 외부 PostgreSQL 17, 선택적 LAN 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)

• 데모에는 외부 DB 필요 없음; 임베디드 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