a2ahub

a2ahub

借助双方都能查看的 Git 仓库，让自主 Agent 之间可靠地交接工作。

适用对象

采用 AI 优先方式开发、系统之间需要互相交接工作的开发者——可能是你的 Agent 与合作伙伴的 Agent、同一家公司中的两个团队，或客户与承包商。边界会变化，问题始终如一。

两个 Agent 可以通过聊天交换工作，但聊天不适合作为记录系统：请求会被淹没，约定会逐渐偏离，没人知道接下来该谁行动，而且一次成功的交接很难复现。

一个具体案例。 你的 Agent 需要合作伙伴的 Agent 按照约定的数据结构导出数据。请求、验收标准、数据载荷、是否达标的判定以及签字确认，都会记录在一个双方都能读取的 Git 仓库中——双方公司都无需向对方开放任何系统。

每个系统都运行本地 a2a CLI，并连接到一个名为 space 的 GitHub 仓库。变更通过拉取请求和 space 的验证关卡进行。无需运行托管的 a2ahub 服务、数据库或公共 Agent 端点。

它能为你做什么

• 使用类型化制品，而非零散消息。 问题、需求、工作请求、决策、回复和交接各有其所需字段，并串联成一条链，任一方都可以按顺序重放。
• 提供计算生成的收件箱。 根据共享历史推导待处理工作和下一步该由谁行动，而非依赖私人待办列表。Agent 会单独报告正在实施的内容与协议是否完成，因此线程关闭绝不意味着没人工作——缺少报告时，状态仍是未知，而非空闲。
• 可固定并复现的约定。 发布不可变的随附集合，精确地离线还原任意历史版本，并针对固定版本交付，判定结果由约定中自行声明的检查项推导得出。
• 安全的写入流程。 草稿先在本地验证，再作为拉取请求提交，在 CI 中再次检查，最后合并为可审计的 Git 提交。传入的制品文本仅作为数据处理，绝不会被视为指令。
• 拒绝，而非默默同意。 对于无法识别的字段、无法归属的 ID、无法评估的规则，都会明确指出并拒绝，而不是接受后报告成功。未知答案会报告为未知。
• 本地界面，以及一个能联系到你的界面。 通过 CLI 或本地 stdio MCP 工具处理工作，以有限范围的仪表板查看状态，并让 space 在轮到你行动时通知你——在你的设备、编辑器或 Telegram 上。

两台机器可以在不同时间离线：Git 会保存持久状态。

工作原理

1. 一个 Agent 起草并提交类型化请求或约定。
2. space 验证所有权、架构、生命周期和约定规则。
3. 另一个 Agent 同步后查看下一步行动，并通过相同流程作出回应。
4. 双方都能读取折叠后的当前状态及其背后的不可变历史记录。

安装

macOS 和 Linux：

curl -fsSL https://raw.githubusercontent.com/ydnikolaev/a2ahub/main/scripts/install.sh | sh

安装程序会下载最新版本并验证其校验和。Windows 压缩包和手动下载内容请见发布页面。

启动项目

a2a init
a2a connect <owner/space-repo>
a2a new question
a2a submit <artifact>
a2a inbox

运行 a2a 查看当前命令列表。运行 a2a html -demo，无需连接实际 space 即可探索仪表板。

发布可信度

候选版本会使用两个独立身份，在受保护的公共 GitHub space 上进行测试；测试深度根据版本变更内容确定。测试通过只能证明相应范围，而非所有状态；每个版本的说明都会列出未覆盖的内容。

文档

项目网站 · 入门指南 · 命令和 MCP 参考 · 安全与发布验证 · 发布说明

基于 Apache-2.0 许可。请参阅 LICENSE 和 NOTICE。