Skip to content
Back to search

chorus-plugins

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chorus-aidlc--chorus/badge.svg)](/listings/chorus-aidlc--chorus)

HTML

<a href="/listings/chorus-aidlc--chorus"><img src="/api/listings/chorus-aidlc--chorus/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://doc.chorus-ai.dev/guides/deployment-overview/)**.

> Hosting on your own machine or connecting a Cloudflare Tunnel? See **[Self-host on a local machine](https://doc.chorus-ai.dev/guides/deploy-local/)** 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](https://doc.chorus-ai.dev/guides/daemon-operations/)** · **[Remote control](https://doc.chorus-ai.dev/guides/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 installations must use their own update workflow. CLI discovery, installation or verification failure stops plugin work.

`--plugins` reads `~/.chorus/daemon.json`, including legacy single-agent records. Explicit Claude Code, Codex, TRAE CLI, Kiro and Pi types are processed even with wake disabled. Each record's home, config directory and PATH are respected; shared destinations update once. Only Chorus and required integration packages are refreshed, with existing credentials and unrelated settings preserved. Host CLIs must already be installed. Kiro templates come from the record's configured Chorus instance (its served version, which may lag npm); conflicting instance URLs for one destination are reported. Stable Pi >=0.99.0 <2.0.0 uses native MCP and targets Chorus only; Pi 0.84.4–0.98.x retains the verified `pi-mcp-adapter@5.0.0` pin. Unknown versions do not trigger adapter changes or an MCP-complete claim; unsupported hosts run no package commands. Updates are targeted, never all-extension; missing capability or incompatible constraints report incomplete work. User pins/ranges are preserved (the verified adapter pin is intentional, not an incomplete latest refresh). Existing native-host adapters and `-builtin:mcp` filters produce scope-specific manual-migration warnings, never automatic removal. See [Pi setup](docs/CONNECT_PI.md).

The command is noninteractive and reports each target. Exit **0** means all requested work completed (missing/empty configuration is a successful no-op); exit **1** means failure or incomplete work, including offline/unknown/untyped records, missing hosts or unsupported targeted updates. Later targets still run after a plugin failure; completed changes are not rolled back. Start new agent sessions and restart the daemon when convenient to activate updates—the command does not restart processes or interrupt sessions.

npm installation has no automatic deadline or forced kill; it shows sanitized progress until npm exits. Queries remain time-limited. Failures include sanitized causes and exit status; permission failures suggest a user-owned Node installation such as nvm. Existing config backups use one `.chorus-upgrade.bak` per file, replaced on the next upgrade.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines
  1. {
  2. "name": "chorus-plugins",
  3. "owner": {
  4. "name": "Chorus-AIDLC"
  5. },
  6. "metadata": {
  7. "description": "Official plugins for the Chorus AI-DLC collaboration platform"
  8. },
  9. "plugins": [
  10. {
  11. "name": "chorus",
  12. "source": "./public/chorus-plugin",
  13. "description": "Chorus AI-DLC collaboration platform plugin. Automates session lifecycle, provides MCP tools for PM/Developer/Admin workflows, and enables multi-agent team observability.",
  14. "version": "0.24.1",
  15. "category": "project-management",
  16. "tags": ["ai-dlc", "collaboration", "mcp", "session", "multi-agent"]
  17. }
  18. ]
  19. }
README.md · README · 170 lines
  1. <p align="center">
  2. <img src="packages/landing/public/images/chorus-slug.png" alt="Chorus" width="240" />
  3. </p>
  4. <p align="center"><strong>The harness for your coding agents. Agents propose, humans verify, software ships.</strong></p>
  5. <p align="center">
  6. <a href="https://discord.gg/SwcCMaMmR">
  7. <img src="https://img.shields.io/badge/Discord-Join%20us-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord">
  8. </a>
  9. <a href="https://github.com/Chorus-AIDLC/Chorus/actions/workflows/test.yml">
  10. <img src="https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/ChenNima/f245ebf1cf02d5f6e3df389f836a072a/raw/coverage-badge.json" alt="Coverage">
  11. </a>
  12. </p>
  13. <p align="center"><strong>English</strong> · <a href="README.zh.md">中文</a> · <a href="README.ko.md">한국어</a> · <a href="README.ja.md">日本語</a></p>
  14. <p align="center"><a href="https://doc.chorus-ai.dev"><strong>📖 Documentation</strong></a></p>
  15. 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.
  16. Inspired by the **[AI-DLC (AI-Driven Development Lifecycle)](https://aws.amazon.com/blogs/devops/ai-driven-development-life-cycle/)** methodology. Core philosophy: **Reversed Conversation** — AI proposes, humans verify.
  17. ---
  18. ## AI-DLC Workflow
  19. ```
  20. Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Verify ──> Done
  21. ^ ^ ^ ^ ^ ^
  22. Human idea:write proposal:write task:write *:admin *:admin
  23. creates + elaborate + drafts + reports + verifies + closes
  24. ```
  25. 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](https://doc.chorus-ai.dev/guides/manage-agents/)
  26. ---
  27. ## What's New
  28. **[v0.24.0](https://chorus-ai.dev/blog/chorus-v0.24.0-release/)**: Organize your agents into a private per-project Team so product work, development tasks, and reviews route to different members. Reviews now run in sessions of their own without development memory, one agent can push several tasks of an Idea at once, and a Quick Task can link directly to an Idea.
  29. **[v0.23.0](https://chorus-ai.dev/blog/chorus-v0.23.0-release/)**: 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.
  30. **[v0.22.2](https://chorus-ai.dev/blog/chorus-v0.22.2-release/)**: 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.
  31. **[v0.22.0](https://chorus-ai.dev/blog/chorus-v0.22.0-release/)**: 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.
  32. **[v0.21.0](https://chorus-ai.dev/blog/chorus-v0.21.0-release/)**: 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.
  33. **[v0.20.0](https://chorus-ai.dev/blog/chorus-v0.20.0-release/)** — 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.
  34. **[v0.19.1](https://chorus-ai.dev/blog/chorus-v0.19.1-release/)** — 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.
  35. **[v0.19.0](https://chorus-ai.dev/blog/chorus-v0.19.0-release/)** — Cloudflare-inspired reviewer rules: clearer scope, complete blocker evidence, and stable finding IDs across rounds. Task reviews now check code quality beyond acceptance criteria.
  36. **[v0.18.0](https://chorus-ai.dev/blog/chorus-v0.18.0-release/)** — 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.
  37. **[v0.17.2](https://chorus-ai.dev/blog/chorus-v0.17.2-release/)** — Pi is now a published, wakeable Chorus agent, and `chorus agents run` switches local agent profiles with one command.
  38. **[v0.17.0–0.17.1](https://github.com/Chorus-AIDLC/Chorus/releases/tag/v0.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.
  39. > Full changelog: [CHANGELOG.md](CHANGELOG.md)
  40. ---
  41. ## Quick Start
  42. Two commands. No database, no Docker, no config files.
  43. ```bash
  44. npm install -g @chorus-aidlc/chorus@0.21.0
  45. chorus
  46. ```
  47. Chorus starts with an embedded PostgreSQL (PGlite), runs migrations, and opens at **http://localhost:8637**. Default login: `admin@chorus.local` / `chorus`.
  48. > Running multiple agents or deploying to production? Use an external PostgreSQL, Docker, or AWS → **[Deploy & self-host](https://doc.chorus-ai.dev/guides/deployment-overview/)**.
  49. > Hosting on your own machine or connecting a Cloudflare Tunnel? See **[Self-host on a local machine](https://doc.chorus-ai.dev/guides/deploy-local/)** for installation, LAN HTTPS, and Cloudflare Named Tunnel setup.
  50. To turn your local machine into an agent runtime that picks up assigned tasks, run `chorus daemon` → **[Daemon operations](https://doc.chorus-ai.dev/guides/daemon-operations/)** · **[Remote control](https://doc.chorus-ai.dev/guides/remote-control/)**.
  51. ### Upgrade the CLI and plugins
  52. ```bash
  53. chorus upgrade # CLI only; `chorus update` is an alias
  54. chorus upgrade --plugins # Also refresh configured agents' Chorus plugins
  55. ```
  56. 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 installations must use their own update workflow. CLI discovery, installation or verification failure stops plugin work.
  57. `--plugins` reads `~/.chorus/daemon.json`, including legacy single-agent records. Explicit Claude Code, Codex, TRAE CLI, Kiro and Pi types are processed even with wake disabled. Each record's home, config directory and PATH are respected; shared destinations update once. Only Chorus and required integration packages are refreshed, with existing credentials and unrelated settings preserved. Host CLIs must already be installed. Kiro templates come from the record's configured Chorus instance (its served version, which may lag npm); conflicting instance URLs for one destination are reported. Stable Pi >=0.99.0 <2.0.0 uses native MCP and targets Chorus only; Pi 0.84.4–0.98.x retains the verified `pi-mcp-adapter@5.0.0` pin. Unknown versions do not trigger adapter changes or an MCP-complete claim; unsupported hosts run no package commands. Updates are targeted, never all-extension; missing capability or incompatible constraints report incomplete work. User pins/ranges are preserved (the verified adapter pin is intentional, not an incomplete latest refresh). Existing native-host adapters and `-builtin:mcp` filters produce scope-specific manual-migration warnings, never automatic removal. See [Pi setup](docs/CONNECT_PI.md).
  58. The command is noninteractive and reports each target. Exit **0** means all requested work completed (missing/empty configuration is a successful no-op); exit **1** means failure or incomplete work, including offline/unknown/untyped records, missing hosts or unsupported targeted updates. Later targets still run after a plugin failure; completed changes are not rolled back. Start new agent sessions and restart the daemon when convenient to activate updates—the command does not restart processes or interrupt sessions.
  59. npm installation has no automatic deadline or forced kill; it shows sanitized progress until npm exits. Queries remain time-limited. Failures include sanitized causes and exit status; permission failures suggest a user-owned Node installation such as nvm. Existing config backups use one `.chorus-upgrade.bak` per file, replaced on the next upgrade.
  60. ---
  61. ## See It in Action
  62. ### Remote Agent Wake — dispatch to a directory, watch it run
  63. ![Remote Agent Wake](packages/landing/public/images/agent-daemon-wake.gif)
  64. Assign an idea to a directory on a remote agent, then open the conversation and watch the local Claude Code pick up the work and run in real time — no terminal, no manual resume.
  65. ### Project Resource Graph — the whole project as a live mind-map
  66. ![Project Resource Graph](packages/landing/public/images/mind-map.png)
  67. Ideas, Proposals, Documents, and Tasks laid out as one connected tree, with each card's status updating live as the agents work.
  68. ### Proposal — AI generates plans in real time
  69. ![Proposal Presence](packages/landing/public/images/proposal-presence.gif)
  70. A PM Agent analyzes requirements and generates a PRD plus a task DAG, with live presence indicators showing agent activity.
  71. ### Kanban — real-time task flow
  72. ![Kanban Presence](packages/landing/public/images/kanban-presence.gif)
  73. Task cards flow between To Do → In Progress → To Verify as agents work, with presence indicators on whatever is being touched.
  74. ---
  75. ## Connect an Agent
  76. The fastest path is the in-app wizard: open **Settings → Setup Guide**. It creates the API key and shows the exact commands for your client — Claude Code, Codex, TRAE CLI, Kiro, dsh, OpenCode, OpenClaw, Pi, Hermes, or any MCP-compatible agent. TRAE CLI setup: [docs/CONNECT_TRAE.md](docs/CONNECT_TRAE.md).
  77. Full per-client guides → **[Agent platforms](https://doc.chorus-ai.dev/reference/agents/)**.
  78. API keys are created under **Settings → Agents → Create API Key**. They start with `cho_` and are shown only once.
  79. ---
  80. ## Tech Stack
  81. | Component | Technology |
  82. |-----------|-----------|
  83. | Framework | Next.js 15 (App Router, Turbopack) |
  84. | Language | TypeScript 5 (strict mode) |
  85. | Frontend | React 19, Tailwind CSS 4, shadcn/ui |
  86. | Data | PostgreSQL 17 + Prisma 7, Redis 7 (optional) |
  87. | Agent Integration | MCP SDK (HTTP Streamable Transport) |
  88. | Auth | OIDC + PKCE / API Key / SuperAdmin |
  89. | i18n | next-intl (en, zh, ko, ja) |
  90. | Deployment | npm / Docker / AWS CDK |
  91. ---
  92. ## Documentation
  93. **📖 Full documentation: [doc.chorus-ai.dev](https://doc.chorus-ai.dev)**
  94. - [Getting started](https://doc.chorus-ai.dev/guides/getting-started/)
  95. - [Connect an agent](https://doc.chorus-ai.dev/reference/agents/)
  96. - [The AI-DLC workflow](https://doc.chorus-ai.dev/guides/ai-dlc-workflow/)
  97. - [Plugins & commands](https://doc.chorus-ai.dev/guides/plugin-commands/)
  98. - [MCP tools reference](https://doc.chorus-ai.dev/reference/mcp-tools/)
  99. - [Deploy & self-host](https://doc.chorus-ai.dev/guides/deployment-overview/)
  100. - [Local self-hosting & Cloudflare Tunnel](https://doc.chorus-ai.dev/guides/deploy-local/)
  101. ---
  102. ## License
  103. AGPL-3.0 — see [LICENSE.txt](LICENSE.txt)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.