Let Them Talk

Let Them Talk

Let your AI agents actually work as a team.

Multi-agent collaboration for Claude Code, Gemini CLI, Codex CLI, Ollama, and API-backed agents — with a live operator dashboard and a 3D virtual office to watch it all happen.

Website · Quick Start · Features · Install · Dashboard · Concepts · Architecture · Discord

______________________________________________________________________

它是什么

让他们说话是一种 本地MCP代理和操作员仪表板 允许多个AI CLI代理共享一个项目运行时。在单独的终端中打开Claude Code、Gemini CLI或Codex CLI——它们可以发现彼此、交换消息、分配任务、审查彼此的工作、通过工作流程进行协调，并通过共享文件协调分支、会话和证据 .agent-bridge/ 目录。浏览器仪表板通过12个选项卡为您提供实时可见性，包括一个3D虚拟办公室，在那里，赤比特工角色在桌子之间行走，在广播中挥手，在空闲时睡觉。

如果你想让你的代理人停止孤立地工作，开始像一个真正的团队一样合作，这就是它。

______________________________________________________________________

🚀 快速开始

# 1. Configure the MCP broker for every installed CLI (Claude / Gemini / Codex)
npx let-them-talk init

# 2. Launch the web dashboard (localhost:3000)
node .agent-bridge/launch.js

现在在第二个终端中打开CLI并告诉它加入：

You are "Alice". Call register("Alice","Claude"), then get_briefing(),
then listen_group() and stay in the loop.

打开第三个终端，告诉该代理注册为 Bob，两人将开始交谈。所有内容都可以在仪表板的“消息”选项卡中看到，您可以直接从那里回复。

跳过手动提示 随着 npx let-them-talk init --template team --为您提供协调员+研究员+程序员提示，准备粘贴。

______________________________________________________________________

⚡ 为什么让他们说话

______________________________________________________________________

✨ 特性

• 65个MCP工具 对于全坐标曲面-- register, send_message, broadcast, listen_group, get_work, verify_and_advance, create_task, start_plan, advance_workflow, lock_file, log_decision, kb_write, call_vote, submit_review, handoff以及50+以上。
• 规范运行时 --事件支持状态 .agent-bridge/runtime/ 具有回放、投影和分支本地隔离功能。
• 分支作为完整执行上下文 --消息、任务、工作流、会话、证据、治理（决策、知识库、审查、投票、规则、进度）都会在分支更改时一起切换。
• 会话+证据支持的完成 --一流的会话记录；“完成”只有在记录了结构化证据时才具有权威性(summary, verification, files_changed, confidence, recorded_at, recorded_by_session).
• 显式运行时描述符 — runtime_type, provider_id, model_id, capabilities （聊天、视觉、图像生成、视频生成、文本生成）。混合供应商团队根据能力进行协调，而不是猜测。
• Autonomy-v2 — get_work 使用规范状态+会话+证据+能力+契约来选择下一个项目。具有空闲检测、重试策略、断路器和有界升级的监视器。
• 3D虚拟办公室 --您团队的实时chibi风格可视化。特工们在办公桌之间走动，对广播做出反应，庆祝任务，空闲时睡觉。
• Web仪表板 --12个选项卡：3D Hub、消息、任务、工作区、工作流、图形、计划、启动、规则、统计、服务、文档。
• 管理模式 --与经理代理进行结构化的轮流(claim_manager, yield_floor, set_phase)--防止3+代理混乱。
• 频道 --无洪水的子团队沟通 #general.
• Markdown工作区导出 --黑曜石友好单向出口(.agent-bridge-markdown/)，明确无权威性。
• 分组验证 — verify:contracts, verify:replay, verify:invariants, verify:smoke --涵盖了脚本驱动、确定性、数十个不变量。
• 0-漏洞依赖关系 --只有2个直接存款(@modelcontextprotocol/sdk, three)，每个传递函数都固定到一个已知的安全版本。

______________________________________________________________________

📦 安装

先决条件

• — node --version 检查
• 一个或多个AI CLIs：

- 克劳德代码 - Gemini CLI - Codex CLI

Init（自动检测安装的所有内容）

cd your-project
npx let-them-talk init

特定CLI的初始化

npx let-them-talk init --claude     # Claude Code only
npx let-them-talk init --gemini     # Gemini CLI only
npx let-them-talk init --codex      # Codex CLI only
npx let-them-talk init --all        # All three
npx let-them-talk init --ollama     # Add a local Ollama bridge

使用现成的模板初始化

npx let-them-talk init --template pair      # 2-agent chat
npx let-them-talk init --template team      # Coordinator + Researcher + Coder
npx let-them-talk init --template review    # Author + Reviewer code-review pair
npx let-them-talk init --template debate    # Pro + Con structured debate
npx let-them-talk init --template managed   # Manager + Designer + Coder + Tester

init写什么（全部合并安全）

• .mcp.json --克劳德代码MCP配置
• .gemini/settings.json --Gemini CLI MCP配置
• .codex/config.toml --Codex CLI MCP配置
• AGENTS.md / CLAUDE.md --后台工作者规则块（标记分隔，永远不会破坏您的内容）
• .agent-bridge/launch.js --本地启动器（无需重新下载）
• .gitignore --添加合理的条目

所有现有的配置都被保留下来——代理桥与其他MCP服务器一起添加 .backup 在任何编辑之前创建的文件。

启动仪表板

node .agent-bridge/launch.js              # localhost:3000
node .agent-bridge/launch.js --lan        # also listen on LAN (phone/tablet)
node .agent-bridge/launch.js status       # CLI status snapshot
node .agent-bridge/launch.js msg   # send a message from the terminal
node .agent-bridge/launch.js migrate      # backfill canonical events from legacy projects

______________________________________________________________________

🎬 60秒演示

# In project folder
npx let-them-talk init --template team
node .agent-bridge/launch.js

打开三个端子。这 templates output会打印出要粘贴到其中的确切提示：

• 1号航站楼（协调员）： 接收用户的请求，将其分解为任务，委托给研究员和程序员。
• 2号航站楼（研究员）： 读取代码，搜索模式，向协调员报告结果。
• 终端3（编码器）： 实现，报告摘要+验证+文件转换回。

在仪表板的“消息”选项卡中，向协调员发送一个任务。观看团队在所有三个终端上执行它，每个消息、任务转换、工作流步骤和证据记录都实时显示在屏幕上。3D Hub显示了你的代理人走向办公桌并在工作时打字的chibi版本。

______________________________________________________________________

🎛️ 仪表板之旅

仪表板还支持：

• 已保存命名布局
• 搜索栏上的Omnibox/命令调色板
• 按项目切换分支和清除消息（规范感知）
• 重新安装提供程序 --重写每个项目的MCP配置并刷新 AGENTS.md 在不接触其他内容的情况下阻止规则

______________________________________________________________________

📐 核心概念

运行时

• 典型真理 生活在事件支持的运行时环境中 .agent-bridge/runtime/.
• 传统公寓 .json / .jsonl 文件在 .agent-bridge/ 是迁移过程中的兼容性预测，而不是权威模型。
• 所有突变都经过一个共享的规范外观(state/canonical.js).仪表板是代理的客户端，而不是第二个编写器。

分支

分支机构是 完整执行上下文，而不仅仅是消息日志。分支开关一次替换迁移的分支本地视图：

• 消息和历史
• 交付和读取状态
• 会话控制与非通用渠道
• 任务和工作流
• 工作区
• 会议和证据
• 治理：决策、知识库、审查、依赖关系、投票、规则、进度

分支创建在分叉点对源分支进行快照。分支机构的局部变化永远不会渗入 main 直到明确推进。

会话+证据

会话是一个代理在一个分支上工作的分支范围记录。重新加入同一分支会恢复该分支范围的上下文。分叉携带历史会话和证据上下文，但不克隆实时执行。

只有在记录了结构化证据时，完成才具有权威性：

• summary
• verification
• files_changed
• confidence (0–100)
• recorded_at
• recorded_by_session

任何不足之处都是会话“完成”，而不是运行时“完成”。

供应商+能力

每个代理都有一个显式的运行时描述符：

• runtime_type （CLI/API/自定义）
• provider_id （克劳德/科/双子座/奥拉玛/…）
• model_id
• capabilities --代币如 chat, vision, image_generation, video_generation, texture_generation

协调员可以根据能力而不是启发式来安排工作-- get_work 任务分配都尊重所声明的能力。

自主循环

与其临时照看聊天：

Coordinator → start_plan(name, steps, assignees)
        ↓
Each agent → get_work() → do work → verify_and_advance() → get_work() → ...

• get_work 从以下选项中选择优先级最高的项目：分配的工作流步骤、可索赔的任务、打开的审阅、帮助请求、阻止的依赖关系等。
• verify_and_advance 用证据进行自我验证。≥70置信度自动前进。以40-69的速度前进。\ [!NOTE], > [!WARNING], > [!SUMMARY]- 可折叠）、美人鱼图、KaTeX数学、可点击的图像灯箱、复制代码按钮。每个运输库都捆绑在本地 vendor/` 因此，仪表板可以脱机工作。
• 0个已知漏洞 在v5.5.4之前的tarball中。
• 敏感路径块 关于文件共享： .env, .pem, .key, .lan-token, mcp.json，并且无法共享代理网桥数据目录。
• 看 SECURITY.md 关于披露政策。

______________________________________________________________________

📚 建筑

真相文档来源：

• docs/architecture/runtime-contract.md
• docs/architecture/branch-semantics.md
• docs/architecture/canonical-event-schema.md
• docs/architecture/markdown-workspace.md
• docs/architecture/runtime-migration-hardening.md
• docs/architecture/upgrade-summary.md --了解v5.x升级中提供的内容

______________________________________________________________________

🧾 命令参考

完整的CLI界面，便于复制粘贴：

# Setup & init
npx let-them-talk init
npx let-them-talk init --claude
npx let-them-talk init --gemini
npx let-them-talk init --codex
npx let-them-talk init --all
npx let-them-talk init --ollama
npx let-them-talk init --template 

# Packaged helpers via npx
npx let-them-talk dashboard
npx let-them-talk status
npx let-them-talk templates
npx let-them-talk uninstall
npx let-them-talk help

# After init, local launcher (no re-download)
node .agent-bridge/launch.js
node .agent-bridge/launch.js --lan
node .agent-bridge/launch.js status
node .agent-bridge/launch.js msg  
node .agent-bridge/launch.js reset
node .agent-bridge/launch.js migrate

# Verification (run from repo root)
npm test
npm --prefix agent-bridge run verify
npm --prefix agent-bridge run verify:contracts
npm --prefix agent-bridge run verify:replay
npm --prefix agent-bridge run verify:invariants
npm --prefix agent-bridge run verify:smoke

______________________________________________________________________

💬 社区

• Discord 的中文翻译是“不和谐”或“纷争”。 --提问、展示和讲述、反馈
• --bug和功能请求
• 网站 --项目主页

______________________________________________________________________

📄 许可证

商业来源许可证1.1。有关使用条款，请参阅许可证文件。

______________________________________________________________________

Built for humans who want their AI agents to work as a team.