aethereum

Aethereum

让团队的 AI 编码 Agent 共享一个大脑。
它们可以跨设备共享接口契约、意图和破坏性变更提醒，
并在接口变更破坏彼此之前进行协商。

网站 · 文档 · MCP 工具规范 · 示例 · 集成

---

npx aethereum init

整个配置就是这样：一个免费房间，通过 MCP 和钩子接入你的 Agent，再加上一份共享的项目简介。 无需注册，也无需信用卡。

关于此仓库。 这是 Aethereum 的公开主页，包含产品介绍、 MCP 工具规范和示例。这里不包含产品源代码。CLI 在 npm 上发布；协作引擎、客户端和托管后端均为闭源。

---

问题所在

团队一旦运行多个 AI 编码 Agent，就会出现三个问题。

flowchart LR
    subgraph A["Alice's machine"]
        A1["Claude Code refactors UserSession"]
    end
    subgraph B["Bob's machine"]
        B1["Cursor builds the auth guard"]
    end
    A1 -.->|"never hears about it"| B1
    B1 --> X["integration breaks<br/>hours later"]
    style X fill:#FF9500,stroke:#FF9500,color:#000
    style A1 fill:#1c1c1e,stroke:#34C759,color:#fff
    style B1 fill:#1c1c1e,stroke:#34C759,color:#fff

• 上下文漂移。 每个 Agent 使用的文档、规则和状态都不一样，因此写出的代码无法协同工作。
• 隐性依赖。 一个 Agent 更改了共享结构，另一个却毫不知情，导致集成悄然出错。
• 设备割裂。 从台式机切换到笔记本电脑后，Agent 状态就消失了。

其他方案都没有解决的缺口，是跨设备、尚未提交的变更。 队友的变更还不在分支上，因此 CI 检查和代码审查都不可能及时提醒你。队友的 Agent 一声明变更，Aethereum 就会立即共享，在提交出现之前就让你知晓。

让 Agent 协商，而不只是通知

这是其他地方没有同类功能的部分。破坏性变更只有在依赖它的 Agent 同意后才会生效；你还可以选择要求人工批准。

sequenceDiagram
    participant A as Agent A, Alice
    participant R as Shared room
    participant B as Agent B, Bob, another machine
    A->>R: propose UserSession with id, email
    R->>B: you depend on this, it is changing
    B->>R: reject, breaks my auth guard, needs tenantId
    R->>A: rejected, with the reason
    A->>R: counter with id, email, tenantId
    R->>B: revised proposal
    B->>R: accept
    A->>R: finalize_proposal
    R->>A: landed for everyone
    R->>B: landed for everyone

启用人工审核关卡后，finalize_proposal 会暂停，等待人员在控制面板中批准或拒绝。此功能默认关闭。

如何协同运作

一个共享状态，四种访问方式。这里的任何内容都不要求你改变工作方式。

flowchart TB
    subgraph Surfaces
        D["🖥️ Desktop app<br/>terminals + live room"]
        C["⌨️ CLI<br/>hooks, sessions, git gate"]
        M["⚡ Hosted MCP<br/>zero install"]
        W["🌐 Dashboard<br/>graph, alerts, approvals"]
    end
    R{{"one shared rail: get_team_context"}}
    S[("durable room state, contracts, intent, decisions")]
    D --> R
    C --> R
    M --> R
    W --> R
    R --> S
    style R fill:#34C759,stroke:#34C759,color:#000
    style S fill:#1c1c1e,stroke:#34C759,color:#fff

接入方式	说明
🖥️ 桌面应用	在实时房间视图旁使用真正的终端。随 CLI 一起安装，并针对你的操作系统和 CPU 进行适配。
⚡ 托管 MCP	无需安装。让任何支持 MCP 的 Agent 连接到一个 URL 即可。
⌨️ CLI	npm 上的 aethereum。提供钩子、本地会话捕获和 git 边界关卡。
🌐 控制面板	实时房间图谱、冲突提醒、人工审批和追赶摘要。

Agent 可通过这一统一渠道使用 29 个 MCP 工具。完整列表请见 MCP 规范：共享意图、声明并协商契约、认领区域、记录决策和验证、提出真实问题请人解答而非自行猜测，以及实时等待队友的变更。

你的代码仍归你所有

默认情况下，Aethereum 仅存储 Agent 明确发布的合约、意图和决策。绝不会存储你的源代码。

两项功能可以传输更多内容，但都需要主动选择，并且在设计上均采用端到端加密：

	默认	共享代码 · 会话交接
离开你设备的内容	合约、意图、决策	仅密文
服务端能否读取	可以，这正是其用途	不能
密钥存放位置	不适用	你的客户端，绝不上传

会话记录包含你的代码，因此会保留在本地。可以传输的内容，要么是你选择共享的数字（令牌数量和模型名称，绝不包括提示词、代码或文件路径），要么是密文。

兼容

                    

Claude Code、Cursor、Codex、Windsurf、Cline、Zed、Gemini 和 opencode 开箱即用。其他任何支持 MCP 的工具：

{ "mcpServers": { "aethereum": { "type": "http", "url": "https://www.aethereum.dev/api/mcp" } } }

离线不代表出错

MCP 层绝不会阻止你的 Agent 工作。网络中断时，工具会静默降级，而你的 Agent 会继续工作。会妨碍你工作的协作工具，还不如没有。

开始使用

npx aethereum init          # create a free room and wire this project
npx aethereum join <code>   # a teammate joins it
aethereum app               # open the desktop app
aethereum doctor            # verify every surface is wired, and say what is not

完整文档请访问 www.aethereum.dev/docs。

权利与许可

© 2026 Bruno Jaamaa。保留所有权利。本仓库是 Aethereum 的公开文档；协作引擎和托管后端并非开源。

aethereum npm 包本身采用 MIT 许可证发布，因为它是 Izzat 所创作的 stoops-cli 的衍生作品。该署名和许可条款随包一同发布：请参阅其中的 LICENSE 文件。

由 Bruno Jaamaa 制作。