consensus

Consensus

为团队提供协作协调，让每位开发者都能在同一代码库上运行 AI 编码 Agent。

Agent 编写代码前，会先声明计划。Consensus 会将该计划与所有其他进行中的计划及团队已有的知识进行比对，并在一秒内给出答复：继续、结合上下文继续或等待。

为什么需要

AI 编码 Agent 速度很快，而且各自独立工作。对于团队而言，这会带来两个 Git 无法发现的问题：

• 发生在互不重叠文件中的设计冲突。 一个 Agent 将会话改为签名令牌；另一个添加了一个假设会话存储在服务器端的登录端点。没有合并冲突。直到几天后的评审中，才发现两种设计互不兼容。
• 每个 Agent 都从零开始。 同一份代码被反复阅读，走过的死胡同被反复尝试，一个 Agent 学到的东西也传不到下一个 Agent。

功能

• 先声明，再编写。 根据计划的含义进行比对，而非根据它们修改的文件。代码尚未产生前就能发现冲突。
• 共享记忆。 Agent 会先询问团队已有的知识，再阅读代码库，并在工作过程中记录发现、决策和走过的死胡同。
• 能积累效益的人工裁决。 两个计划确实冲突时，由人做出一次决定。裁决会被保存，并自动应用于之后所有可能引发相同冲突的计划。
• 清晰交接。 工作完成后，Agent 会记录变更内容、未改动的部分及所依据的假设。这些内容会成为拉取请求。

Consensus 从不读取、编写、执行或合并代码。

工作原理

1. 通过一次大模型调用提取计划的立场：计划涉及的概念，以及在错误处理、身份验证、数据访问和 API 形式方面的取向。未涉及的维度保持为空；不会凭空推测。
2. 通过向量搜索检索最相关的未结计划和记忆条目。
3. 以确定性方式比对计划。概念相同但立场不同即为冲突。输入相同，答案相同，每项输入都会记录。
4. 在请求人工处理之前，先检查严重冲突是否与既有裁决相符。

完整详情：工作原理。

连接 Agent

Consensus 是一个 MCP 服务。每位开发者创建个人 API 密钥（在设置页面创建，或使用 POST /api/me/api-keys），然后将编码 Agent 连接到该服务。

Claude Code，带防护机制（推荐）。此插件会添加服务、用于说明工作流的技能，以及一个钩子：在计划声明完成且裁定允许前，拒绝执行 Edit/Write：

export CONSENSUS_API_KEY="csk_..."          # CONSENSUS_URL defaults to the hosted instance
claude plugin marketplace add masterblaster14/Consensus
claude plugin install consensus@consensus

Claude Code，仅连接服务：

claude mcp add --transport http consensus https://consensus-production-aed6.up.railway.app/mcp --header "Authorization: Bearer csk_..."

Cursor、Windsurf，以及任何 MCP 客户端。 添加到客户端的 MCP 配置中：

{ "mcpServers": { "consensus": { "url": "https://consensus-production-aed6.up.railway.app/mcp", "headers": { "Authorization": "Bearer csk_..." } } } }

已作为 io.github.masterblaster14/consensus 列入 MCP Registry，因此支持 Registry 的客户端可以按名称找到它。

Agent 的所有操作都会归属到持有密钥的开发者。可用工具：declare_intent、check_verdict、query_memory、write_memory、file_handoff、withdraw_claim、get_status、report_usage。

团队与集成

• 使用 GitHub 登录或通过电子邮件链接登录。第一个创建组织的人将成为管理员；其他人可通过邀请链接或电子邮件域名加入。
• 每个代码仓库都有一个共享的实时看板。
• GitHub：交接会创建拉取请求，裁决会成为 PR 评论，已合并的 PR 会结束相应计划。
• Notion：任务会同步进来，决策和裁决会同步出去。

托管实例：https://consensus-production-aed6.up.railway.app（API 文档位于 /docs，实时看板位于 /board）。

运行

需要 Python 3.11、带 pgvector 的 PostgreSQL 和 Redis。使用 Docker Compose 运行数据库。离线模式无需 API 密钥。

docker compose up -d
.venv/Scripts/python -m alembic upgrade head
.venv/Scripts/python -m scripts.seed_demo
.venv/Scripts/python -m uvicorn app.main:app --port 8000

也可以在容器中运行整个技术栈：docker compose --profile full up -d --build。

有关设置详情、配置和完整 API，请参阅：后端参考。有关托管方式，请参阅：部署（Render blueprint、Railway、Fly 或任何 Docker 主机）。

许可证

MIT。请参阅 LICENSE。

Documentation

• Getting started
• How it works
• Features
• Pitch briefing and Q&A
• Demo script and demo runbook
• Backend reference
• Pricing