Chorus

Full changelog: CHANGELOG.md

Quick Start

Run Chorus locally with two commands — no database, no Docker, no config files needed.

npm install -g @chorus-aidlc/chorus
chorus

That's it. Chorus starts with an embedded PostgreSQL (PGlite), runs migrations automatically, and opens at http://localhost:8637.

Note: PGlite is an embedded, single-process PostgreSQL — great for local single-user usage, but its connection handling has limits under concurrent load. If you plan to run multiple agents or users simultaneously, use an external PostgreSQL via DATABASE_URL=postgresql://... or the full Docker Compose stack.

Default login: admin@chorus.local / chorus

Options

# Custom port
chorus --port 3000

# Custom data directory (default: ~/.chorus-data)
chorus --data-dir /path/to/data

# Custom credentials
DEFAULT_USER=me@example.com DEFAULT_PASSWORD=secret chorus

# Use an external PostgreSQL instead of embedded PGlite
DATABASE_URL=postgresql://user:pass@host:5432/chorus chorus

Other deployment options

| Method | Command | |--------|---------| | npm (simplest) | npm i -g @chorus-aidlc/chorus && chorus | | Docker (standalone) | docker compose -f docker-compose.local.yml up | | Docker (full stack) | docker compose up (PostgreSQL + Redis + Chorus) | | AWS CDK | Deploy to AWS |

Screenshots

Proposal — AI Agent Generates Plans in Real Time

Watch a PM Agent analyze requirements and generate a proposal with PRD and task DAG — with real-time presence indicators showing agent activity.

Pixel Workspace — Real-time Agent Status

The left panel is a pixel workspace where pixel characters represent each Agent's real-time working status; the right panel shows live Agent terminal output.

Kanban — Real-time Task Flow

The Kanban board updates automatically as Agents work, with task cards flowing between To Do → In Progress → To Verify in real time. Agent presence indicators highlight which resources are being worked on.

Kanban & Task DAG

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

Idea & Requirements Elaboration

PM Agents clarify requirements through structured Q&A rounds before creating Proposals. The panel shows idea details alongside completed elaboration rounds with answers and category tags.

Proposal Review

Proposals generated by the PM Agent contain document drafts and task DAG drafts. Admins review and approve or reject on this panel.

Acceptance Criteria — Dual-Path Verification

Dev Agent self-checks and Admin reviews each acceptance criterion independently, with structured pass/fail evidence for every item.

Universal Search — Cmd+K Command Palette

A Cmd+K command palette for searching across all 6 entity types (Tasks, Ideas, Proposals, Documents, Projects, Project Groups). Supports scope filtering (Global / Group / Project), filter tabs per entity type, and keyboard navigation. Both the Web UI and AI agents (via chorus_search MCP tool) share the same search backend.

Features

• Session Lifecycle — Persistent sessions with heartbeats, auto-expiry, and failure recovery
• Task DAG — Dependency modeling, cycle detection, and interactive visualization
• Kanban — Real-time task flow with Worker badges and agent presence
• Multi-Agent Collaboration — Claude Code Agent Teams (Swarm Mode) for parallel execution
• Chorus Plugin — Lifecycle hooks automate session create/close, heartbeats, and context injection
• Requirements Elaboration — Structured Q&A rounds before proposal creation
• Proposal Approval Flow — PM drafts, Admin approves, drafts materialize into real entities
• Notifications — In-app + SSE push + Redis Pub/Sub with per-user preferences (design doc)
• @Mention — Tiptap autocomplete, permission-scoped search, mention notifications (design doc)
• Activity Stream — Full audit trail with session attribution
• Universal Search — Cmd+K across 6 entity types, 3 scope levels, snippet generation (design doc)

Architecture

┌──────────────────────────────────────────────────────────────────┐
│                 Chorus — Agent Harness (:8637)                    │
│                                                                  │
│  ┌── Harness Capabilities ───────────────────────────────────┐   │
│  │  Session Lifecycle │ Task State Machine │ Context Inject   │   │
│  │  Sub-Agent Orchestration │ Observability │ Failure Recovery│   │
│  └───────────────────────────────────────────────────────────┘   │
│                                                                  │
│  ┌── Chorus Plugin (lifecycle hooks) ────────────────────────┐   │
│  │  SubagentStart/Stop │ Heartbeat │ Skill & Context Inject  │   │
│  └───────────────────────────────────────────────────────────┘   │
│                                                                  │
│  ┌── API Layer ──────────────────────────────────────────────┐   │
│  │  /api/mcp  — MCP HTTP Streamable (50+ tools, role-based)  │   │
│  │  /api/*    — REST API (Web UI + SSE push)                 │   │
│  └───────────────────────────────────────────────────────────┘   │
│                                                                  │
│  ┌── Service Layer ──────────────────────────────────────────┐   │
│  │  AI-DLC Workflow │ UUID-first │ Multi-tenant              │   │
│  └───────────────────────────────────────────────────────────┘   │
│                                                                  │
│  ┌── Web UI (React 19 + Tailwind + shadcn/ui) ──────────────┐   │
│  │  Kanban │ Task DAG │ Proposals │ Activity │ Sessions      │   │
│  └───────────────────────────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────────────┘
     ↑              ↑              ↑              ↑
  PM Agent    Developer Agent  Admin Agent      Human
   (LLM)         (LLM)          (LLM)        (Browser)
                     │
          ┌──────────▼──────────┐   ┌─────────────────────┐
          │  PostgreSQL + Prisma │   │  Redis (optional)   │
          └─────────────────────┘   │  Pub/Sub for SSE    │
                                    └─────────────────────┘

Packages

| Package | Description | |---------|-------------| | packages/openclaw-plugin | OpenClaw Plugin — Connects OpenClaw to Chorus via persistent SSE + MCP bridge. | | packages/chorus-cdk | AWS CDK — Infrastructure-as-code for deploying Chorus to AWS. |

Tech Stack

| Component | Technology | |-----------|-----------| | Framework | Next.js 15 (App Router, Turbopack) | | Language | TypeScript 5 (strict mode) | | Frontend | React 19, Tailwind CSS 4, shadcn/ui (Radix