v0.5.1

Added

• New User Onboarding Wizard: Full-screen step-by-step wizard at /onboarding guides new users through agent creation, API key copy, client install, and connectivity test via real-time SSE detection. (#63)
• UI Animation System: Comprehensive framer-motion animations — page transitions, list stagger, sidebar nav indicator, collapsible expand/collapse, notification badge pulse, and form submit feedback. (#57)
• Quick-Dev Skill: New skip-proposal workflow skill for both plugin and standalone agents. (#61)

Changed

• Projects Page Redesign: Replaced card grid with compact list view, extracted shared project color utility. (#62)
• Task Tools Migrated to Public Layer: chorus_create_tasks and chorus_update_task moved from role-specific to public MCP tools, enabling all roles to create/edit tasks directly. (#61)
• Skill Documentation Split: Monolithic skill docs split into 5 modular skills by AI-DLC stage (chorus, idea, proposal, develop, review) for both plugin and standalone. (#59, #60)

Fixed

• OIDC Cookie Expiry Mismatch: Derive oidc_access_token cookie maxAge from JWT exp claim instead of hardcoded 1h. (#56)
• DAG/Kanban Render Issues: Fix ReactFlow height propagation, remove framer-motion wrapper breaking node measurement, guard duplicate Cmd+K search dialog. (#58)

Plugin

• Plugin version bumped to 0.5.2 with enhanced quick-dev skill (admin self-verify, AC guidance). (#64)

v0.5.0

Added

• Universal Search: Global search across tasks, ideas, proposals, documents, projects, and project groups with unified MCP tool and UI. (#50)
• Rich Claim/Assign Response: chorus_claim_task and chorus_pm_assign_task now return full task details and dependency hints, eliminating extra round-trips for agents. (#52)

Changed

• DEFAULT_USER Session Extended to 365 Days: Default user sessions no longer expire frequently, reducing unnecessary logouts. (#53)

Fixed

• Settings Page Role Badges: Replaced checkbox role display with Badge components on the settings page. (#54)

Docs

• Added search technical design document and architecture reference. (#51)

v0.4.2

Added

• Multi-project Filtering: Filter by multiple projects via MCP headers. (#37)
• Team Lead Verify Reminders: Auto-remind team leads to verify completed tasks via plugin hooks. (#44)

Changed

• MCP Session Sliding Window Expiration: Sessions now use sliding window expiration instead of fixed timeout. (#39)
• TypeScript Strict CI: Added tsc --noEmit to CI pipeline and resolved 27 type errors in test files. (#41)
• Fork PR Coverage Comments: Enabled coverage PR comments for fork PRs via workflow_run. (#42)

Fixed

• MCP Draft/Approve UUID Returns: Draft and approve tools now return created UUIDs, eliminating extra round-trips. (#48)
• SubagentStop Hook Context Injection: Removed async from SubagentStop hook to fix context injection. (#47)
• Verify Reminder Hook Placement: Moved verify reminder from TaskCompleted to SubagentStop hook for reliability. (#45)

Docs

• Updated Chorus vs Plane comparison to v2.0 and added Linear AI-DLC plugin report. (#40)

v0.4.1

Added

• Proposal-based Task Filtering: Filter tasks by source proposal across UI, API, MCP tools, and plugins. (#34)
• Idea Reuse Across Proposals: An Idea can now be linked to multiple Proposals, enabling iterative refinement. (#29)
• Delete Proposal Button: Added frontend button to delete proposals directly from the UI. (#27)
• Simplified Proposal MCP: Empty shell proposal creation + relaxed E1 validation for faster PM workflows. (#25)
• PR Workflow Skill: New pr-workflow skill for branch/PR/CI/merge workflow automation. (#33)
• Unit Test Coverage: Added Vitest test suite — Phase 1 (417 tests), Phase 2 (736 tests, 71.5%), Phase 3 (984 tests, 95.3%). (#21, #22, #23)
• Coverage Badge: README now displays dynamic test coverage badge via shields.io. (#24)

Changed

• OpenClaw Plugin Config: All config params are now optional with missing-config warnings instead of hard errors. (#31)

Fixed

• Legacy Acceptance Criteria: Removed legacy markdown acceptance criteria from task draft editing. (#32)

v0.4.0

Added

• Structured Acceptance Criteria: Dual-track verification system — developer self-check + admin verification per criterion. New AcceptanceCriterion Prisma model as independent table, with chorus_report_criteria_self_check and chorus_mark_acceptance_criteria MCP tools. Kanban cards show acceptance progress badges, task detail panel displays criterion cards with pass/fail actions. Full i18n support. (#18)
• Task Dependency Enforcement: Tasks cannot move to in_progress when their dependencies are unresolved. Kanban UI shows lock icon + blocked banner with force-move confirmation dialog for admins. New checkDependenciesResolved() service method with enriched blocker info. chorus_admin_reopen_task gains force parameter for admin bypass. (#16)
• COOKIE_SECURE Environment Variable: Support COOKIE_SECURE=false for HTTP-only deployments. Extracted getCookieOptions() helper to eliminate 8 duplicate cookie config blocks. Updated Docker Compose and documentation. (#19)

Changed

• Session Management Simplified: Removed manual session lifecycle management from skill docs. Plugin sessions are fully automated by hooks; standalone skill removes session tools entirely.
• Unblocked Tasks Rule: getUnblockedTasks now requires dependencies to be done or closed (previously accepted to_verify).

Fixed

• Code Block Horizontal Scroll: Fixed horizontal scroll for code blocks in task draft detail panel by overriding ScrollArea's display:table to display:block.

Plugin

• Chorus Plugin bumped to v0.2.1 (session docs clarification, dependency enforcement, acceptance criteria).
• OpenClaw Plugin bumped to v0.2.1: new admin-tools.ts module with chorus_admin_create_project_group and chorus_mark_acceptance_criteria; added chorus_get_project_groups / chorus_get_project_group to common tools; event router handles task_verified / task_reopened. (#20)

v0.3.0

Added

• Move Idea Across Projects: New chorus_move_idea MCP tool and UI support to move ideas between projects.
• RESTful Panel URLs: Ideas and Tasks side panels now have shareable RESTful URLs for direct linking.
• Code Syntax Highlighting: Comments now render code blocks with syntax highlighting.
• Mobile Responsive Layout: All dashboard pages are now mobile-friendly with responsive design.
• Sessionless Pixel Workers: Agents without active sessions now appear as pixel workers on PixelCanvas.
• OpenClaw assign_task Tool: Added assign_task tool and reviewNote approval support to the OpenClaw plugin.

Changed

• Chorus Repositioned as Agent Harness: Updated documentation to reposition Chorus as an Agent Harness platform.

Fixed

• Code Block Scroll/Buttons: Fixed code block overflow scrolling and button display in proposal document view.
• Detail Panel Flash: Prevented detail panel flash on comment submit.
• Wide Content Overflow: Fixed wide content overflow in comments.
• Agent Edit Name Persistence: Agent edit now persists name correctly and keeps API key valid.
• OpenClaw Plugin entityUuid: Include entityUuid in OpenClaw plugin notification messages.
• MCP String-encoded Array Params: Coerce string-encoded array params in MCP tools.

Plugin

• Bumped plugin versions for chorus_move_idea support.

v0.2.0

Added

• OpenClaw Integration: New @chorus-aidlc/chorus-openclaw-plugin — an OpenClaw-compatible plugin with SSE + MCP bridge, enabling Chorus to work with any OpenClaw-supported IDE or agent. Includes 12 exploration tools and admin create tools.
• Edit Agent Modal: Edit agent name, persona, and system prompt directly from the settings page.
• Agent Owner Awareness: Agents are linked to their human owner, enabling owner-scoped @mention workflow and new search_mentionables MCP tool.
• @Mention Defaults to Own Agents: @mention dropdown defaults to the current user's own agents for faster tagging.
• Real-time Comment Updates: SSE-powered live comment sync for Idea, Task & Proposal detail panels.

Changed

• create_idea Permission Level: Moved from Admin-only to PM permission level, allowing PM agents to create ideas directly.

Fixed

• Notification Scoping: Elaboration and task_verify notifications are now scoped to relevant parties instead of broadcasting to all admin agents.
• Duplicate Event Emission: Removed duplicate eventBus.emit in elaboration service.
• Missing Activity Events: Added activity events for idea assign and proposal actions triggered from the UI.
• Event Router ProjectUuid: Include projectUuid in all event-router trigger messages for proper SSE routing.

v0.1.1

Added

• Plugin Bash 3.2 compatibility, macOS support: Fixed ${VAR,,} Bash 4+ syntax in hook scripts for macOS /bin/bash 3.2 compatibility. Added test-syntax.sh script to verify plugin hook compatibility.
• Proposal Validation Checklist: Pre-submission validation with 12 checks (5 errors, 5 warnings, 2 info) across document completeness, task quality, and DAG structure. New chorus_pm_validate_proposal MCP tool for PM agents. Collapsible frontend checklist with error/warning count badges and full i18n support (ICU plurals).
• chorus_list_projects MCP tool: List all projects regardless of project group — available to all authenticated agents.
• ungroupedCount in project groups: chorus_get_project_groups now returns the count of ungrouped projects.

Fixed

• Project group completion rate always showing 0%: getGroupStats was hardcoding completedTasks: 0 instead of summing from each project. Group dashboard also now counts both "done" and "closed" tasks.
• Tasks page performance storm: Batch DB queries reduce ~82 queries to ~4 for task listing. Added batchGetActorNames(), batchFormatCreatedBy(), formatTaskResponsesBatch(), and batchGetWorkerCountsForTasks(). SSE throttled to 3s + 1s debounce to limit router.refresh() during active agent work.

Plugin

• Bumped Chorus Plugin from v0.1.7 to v0.1.9.

v0.1.0 — First Public Release

Chorus v0.1.0

The first public release of Chorus — an AI Agent & Human collaboration platform implementing the AI-DLC (AI-Driven Development Lifecycle) methodology.

Core philosophy: "Reversed Conversation" — AI proposes, humans verify.

---

Quick Start with Docker Compose

The fastest way to run Chorus — no build tools required:

git clone https://github.com/Chorus-AIDLC/Chorus.git
cd Chorus

export DEFAULT_USER=admin@example.com
export DEFAULT_PASSWORD=changeme
docker compose up -d

Open http://localhost:3000 and log in with the credentials above.

Pulls chorusaidlc/chorus-app (amd64 & arm64), starts PostgreSQL + Redis, and runs database migrations automatically.

Docker Run (if you already have PostgreSQL and Redis)

docker run -d \
  -p 3000:3000 \
  -e DATABASE_URL=postgresql://user:pass@your-db-host:5432/chorus \
  -e REDIS_URL=redis://default:password@your-redis-host:6379 \
  -e NEXTAUTH_SECRET=$(openssl rand -base64 32) \
  -e DEFAULT_USER=admin@example.com \
  -e DEFAULT_PASSWORD=changeme \
  chorusaidlc/chorus-app:latest

Local Development

cp .env.example .env          # Configure environment
pnpm docker:db                # Start PostgreSQL + Redis
pnpm install && pnpm db:migrate:dev && pnpm dev

For all environment variables and deployment options (including AWS CDK), see Docker Documentation.

---

Connect AI Agents

1. Create API Keys

Go to Settings > Agents > Create API Key on the Web UI. Create at least one PM key and one Developer key.

2. Chorus Plugin for Claude Code (Recommended)

export CHORUS_URL="http://localhost:3000"
export CHORUS_API_KEY="cho_your_api_key"

claude
# Then in Claude Code:
/plugin marketplace add Chorus-AIDLC/chorus
/plugin install chorus@chorus-plugins

3. Or manual MCP configuration

Create .mcp.json in your project root:

{
  "mcpServers": {
    "chorus": {
      "type": "http",
      "url": "http://localhost:3000/api/mcp",
      "headers": {
        "Authorization": "Bearer cho_your_api_key"
      }
    }
  }
}

Works with Claude Code, Cursor, Kiro, and any MCP-compatible client.

---

What's in v0.1.0

Zero Context Injection

Agents automatically know "who I am" and "what to do" — no manual onboarding needed. chorus_checkin returns persona, pending assignments, project context, and notifications.

AI-DLC Workflow

Complete closed-loop: Idea → Elaboration → Proposal → Document + Task DAG → Execute → Verify → Done

• Requirements Elaboration with structured multi-round Q&A
• PM Agent drafts PRD + task breakdown → human reviews → approve/reject
• Task DAG with dependency management and cycle detection
• Agent Hours as the new effort metric

Multi-Agent Awareness

• Agent Sessions with checkin/checkout, heartbeat, and auto-expiry
• SSE real-time updates for Kanban, Ideas, and Proposals
• Activity stream with full audit trail and session attribution
• @Mentions with notification delivery
• Animated pixel art workers on Kanban cards

Web UI

• Project dashboard with groups, completion rates, and aggregated stats
• Kanban board with drag-and-drop
• Interactive DAG visualization
• Proposal review workflow with document/task draft panels
• Full i18n (English + Chinese)

40+ MCP Tools

Role	Prefix	Responsibility
PM Agent	chorus_pm_*	Analyze ideas, create proposals, manage documents, assign tasks
Developer Agent	chorus_*_task	Claim tasks, report progress, submit for verification
Admin Agent	chorus_admin_*	Create projects/ideas, approve proposals, verify tasks

Auth & Deployment

• OIDC / API Key (cho_ prefix) / Default username-password auth
• Multi-tenant company isolation
• Docker image (multi-arch) / Docker Compose / AWS CDK

---

See the full CHANGELOG and README for details.