Agentic Comm

Structured communication for AI agents.

Channels, messaging, pub/sub, and coordination. One file. Any model.

Problems Solved · Quickstart · How It Works · MCP Tools · Benchmarks · Install · Papers · API

______________________________________________________________________

每个AI代理都是一座孤岛。

克劳德不能告诉GPT它发现了什么。您的代码审查代理无法通知您的部署代理。从事同一项目的两个代理没有共享通道。 每个特工都在沉默中工作。

当前的修复程序不起作用。共享文件容易发生竞争——两个代理同时写入会破坏一切。Webhooks依赖于云——你需要一个简单消息的基础设施。聊天记录是非结构化的——没有主题，没有频道，没有选择性订阅。数据库队列很重——您需要一台服务器来进行本地操作。

代理通信 在单个二进制文件中为您的代理提供结构化通信。不“发送HTTP请求”。您的代理有 频道 --具有发布/订阅、消息排序、传递跟踪和持久性的命名主题——所有这些都是本地的，都可以在微秒内查询。

已解决的问题（请先阅读）

• 问题： 代理在会话之间不能相互交谈。

解决了的： 持久的 .acomm 文件在重启、模型切换和会话之间的长时间间隔中幸存下来。

• 问题： 没有结构化的方法来协调多代理工作流。

解决了的： 具有发布/订阅、消息排序和选择性订阅的命名频道。

• 问题： 信息丢失或到达顺序错误。

解决了的： 具有传递确认和重放功能的序列号消息。

• 问题： 项目之间的沟通状态不佳。

解决了的： 每个项目 .acomm 具有基于路径隔离的文件。

• 问题： 代理协调需要云基础设施。

解决了的： 一切都在本地运行。没有服务器，没有API，没有云依赖。

操作命令（CLI）：

acomm channel list --format json
acomm send "deploy-coord" "build complete"
acomm receive "deploy-coord" --limit 10

17个MCP工具。一个文件包含所有内容。适用于Claude、GPT、Ollama或您接下来切换到的任何LLM。

______________________________________________________________________

MCP工具

AgenticComm曝光 17个MCP工具 对于AI代理：

渠道工具

消息传递工具

发布/子工具

查询工具

上下文工具

MCP提示

comm_coordinate     -- Multi-agent coordination workflow
comm_review         -- Communication health check
comm_plan           -- Communication channel planning

______________________________________________________________________

基准测试

锈芯。零拷贝访问。标准统计基准的绩效目标：

在Apple M4 Pro、64 GB、Rust 1.90.0上使用Criterion（100个样本）测量的目标 --release.

容量： 多年的代理沟通 .acomm 文件。专为长时间运行的多代理协调而设计，无需担心增长问题。

Comparison with existing approaches

______________________________________________________________________

为什么选择AgenticComm

沟通是一种结构，而不是一条平坦的溪流。 当代理协调时，他们需要命名通道、有序消息、选择性订阅和交付保证。这就是结构化的沟通。共享文本文件永远无法提供此功能。

一个文件。真正便携。 您的整个通信状态是单一的 .acomm 文件。复制它。备份它。版本控制。没有云服务，没有API密钥，没有供应商锁定。

任何法学硕士，任何时候。 今天从克劳德开始。明天切换到GPT。明年改用本地模式。相同的通信文件。

______________________________________________________________________

安装

一个衬垫 （桌面配置文件，向后兼容）：

curl -fsSL https://agentralabs.tech/install/comm | bash

下载预构建 agentic-comm-mcp 二进制到 ~/.local/bin/ 并将MCP服务器合并到您的Claude Desktop和Claude Code配置中。需要 curl 和 jq. 如果发布工件不可用，安装程序会自动回退到 cargo install --git 源代码安装。

环境概况 （每个环境一个命令）：

# Desktop MCP clients (auto-merge Claude Desktop + Claude Code when detected)
curl -fsSL https://agentralabs.tech/install/comm/desktop | bash

# Terminal-only (no desktop config writes)
curl -fsSL https://agentralabs.tech/install/comm/terminal | bash

# Remote/server hosts (no desktop config writes)
curl -fsSL https://agentralabs.tech/install/comm/server | bash

服务器身份验证和工件同步

对于云/服务器运行时：

export AGENTIC_TOKEN="$(openssl rand -hex 32)"

所有MCP客户端必须发送 Authorization: Bearer .

Detailed install options

开发包 （要求 acomm Rust二进制）：

pip install agentic-comm

Rust CLI+MCP：

cargo install agentic-comm-cli       # CLI (acomm)
cargo install agentic-comm-mcp       # MCP server

Rust库：

cargo add agentic-comm

部署模型

• 默认情况下为独立： AgentComm可独立安装和操作。与AgentMemory或其他姐妹的整合是可选的，从来不是必需的。
• 默认情况下按项目隔离： 每个项目都有自己的 .acomm 文件。

______________________________________________________________________

MCP服务器

任何兼容MCP的客户端都可以即时访问结构化代理通信。 这 agentic-comm-mcp crate暴露了整个AgentComm引擎 模型上下文协议 （JSON-RPC 2.0通过标准输入）。

cargo install agentic-comm-mcp

配置Claude桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agentic-comm": {
      "command": "agentic-comm-mcp",
      "args": ["serve"]
    }
  }
}

零配置：默认为自动检测 .acomm 在当前项目中。覆盖 "args": ["--file", "/path/to/project.acomm", "serve"].

配置VS代码/光标

添加 .vscode/settings.json:

{
  "mcp.servers": {
    "agentic-comm": {
      "command": "agentic-comm-mcp",
      "args": ["serve"]
    }
  }
}

独立

# Run directly
agentic-comm-mcp serve

# With explicit file
agentic-comm-mcp --file /path/to/project.acomm serve

AgentComm可独立安装和操作。无需其他Agentra姐妹。与代理记忆、代理身份或其他姐妹的整合是可选的和可添加的。

______________________________________________________________________

快速入门

1.安装

curl -fsSL https://agentralabs.tech/install/comm | bash

2.创建频道

acomm channel create "code-review" --type direct

3.发送消息

acomm send "code-review" "Found 3 issues in auth module, see PR #42"

4.接收消息

acomm receive "code-review" --format json

5.问你的经纪人

安装并重新启动MCP客户端后，询问您的代理：

Send a message to the deploy-coord channel saying the build passed

代理人打电话来 comm_send 并将其保存到您的 .acomm 文件。

What messages are in the code-review channel?

代理人打电话来 comm_receive 并返回消息历史记录。

______________________________________________________________________

常见工作流

1. 多智能体协调 --创建部署协调渠道：

   acomm channel create "deploy" --type pubsub
   acomm send "deploy" "build passed on commit abc123"
   acomm send "deploy" "staging deploy complete"

1. 代码审查交接 --在审查和修复代理之间传递调查结果：

   acomm channel create "review-findings" --type direct
   acomm send "review-findings" "SQL injection in auth.rs line 42"

1. 状态广播 --向所有已订阅的代理广播状态：

   acomm broadcast "CI passed" --channels "deploy,monitor,notify"

1. 消息搜索 --查找相关通信历史：

   acomm search "deploy" --channel "deploy" --limit 20

1. 通信健康 --检查通道统计信息：

   acomm stats --format json

______________________________________________________________________

运作原理

AgentComm通过以下方式模拟代理通信 渠道和信息 以自定义二进制格式。每个渠道都有自己的消息排序、订阅跟踪和交付保证。该文件可以跨模型、客户端和部署进行移植。

为了提高性能和安全性，核心运行时是用Rust编写的。所有州都住在一个便携式 .acomm 二进制文件——没有外部数据库，没有托管服务。MCP服务器通过JSON-RPC stdio公开了完整的引擎。

______________________________________________________________________

核心概念：

通道类型： direct . pubsub . broadcast

二进制 .acomm 文件 使用固定大小的记录（O（1）访问）、LZ4压缩内容和内存映射I/O。没有解析开销。没有外部服务。即时访问。

File format details

+-------------------------------------+
|  HEADER           64 bytes          |  Magic (ACOM) . version . channel counts . feature flags
+-------------------------------------+
|  CHANNEL TABLE    fixed-size rows   |  name . type . subscriber_count . message_count . created_at
+-------------------------------------+
|  MESSAGE TABLE    fixed-size rows   |  channel_id . sender . content_ref . seq_num . timestamp . acked
+-------------------------------------+
|  SUBSCRIPTION TABLE  fixed-size     |  channel_id . subscriber_id . filter . created_at
+-------------------------------------+
|  CONTENT BLOCK    LZ4 compressed    |  UTF-8 text for message content and metadata
+-------------------------------------+

______________________________________________________________________

验证

______________________________________________________________________

存储库结构

这是一个Cargo工作区monorepo，包含核心库、MCP服务器、CLI和FFI绑定。

agentic-comm/
├── Cargo.toml                    # Workspace root
├── crates/
│   ├── agentic-comm/             # Core library (crates.io: agentic-comm)
│   ├── agentic-comm-cli/         # CLI (crates.io: agentic-comm-cli)
│   ├── agentic-comm-mcp/         # MCP server (crates.io: agentic-comm-mcp)
│   └── agentic-comm-ffi/         # FFI bindings (crates.io: agentic-comm-ffi)
├── python/                       # Python SDK (PyPI: agentic-comm)
├── paper/                        # Research papers
├── docs/                         # Documentation
└── scripts/                      # CI and guardrail scripts

运行测试

# All workspace tests (unit + integration)
cargo test --workspace

# Core library only
cargo test -p agentic-comm

# Stress tests
cargo test --test "*stress*" --test "*boundary*" --test "*edge*"

# Benchmarks
cargo bench -p agentic-comm

______________________________________________________________________

姐妹融合

AgenticComm独立工作，但与其他Agentra姐妹公司集成：

• 代理身份：使用身份回执签名的邮件。通道访问由信任授予控制。
• 能动记忆：链接到内存节点的通信历史。消息上下文丰富了内存图。
• 机构愿景：通过通信渠道共享视觉观察结果。发送给订阅代理的屏幕截图通知。
• 代理代码库：通过结构化渠道传达代码审查结果。通过pub/sub进行部署协调。
• 代理时间：计划邮件传递。通道活动衰减跟踪。
• 代理合同：通过合同执行的通信协议。渠道SLA和交付保证。

______________________________________________________________________

.acomm文件

你的代理人的通信。一个文件。永远属于你。

| | | |-|-| |格式|便携式二进制通信图| |适用于|克劳德、GPT、Llama、任何型号|

两个目的：

1. 坚持：通道、消息和订阅在会话中仍然有效
2. 协调：加载到任何模型中——代理突然可以通信

模型是商品。你的.ACOM就是价值。

______________________________________________________________________

隐私与安全

• 所有数据都保留在本地 .acomm 默认情况下，没有遥测，没有云同步。
• 每个项目的隔离确保了项目之间的通信数据永远不会泄露。
• 消息内容与完整性校验和一起存储，以检测损坏。
• 通道访问可以通过AgentIdentity信任授予进行控制。
• 服务器模式要求显式 AGENTIC_TOKEN 承载身份验证的环境变量。

______________________________________________________________________

贡献

看 贡献.md.最快的帮助方式：

1. 试试看 和 文件问题
2. 添加MCP工具 --扩展通信能力
3. 写一个例子 --展示一个真实的用例
4. 改进文档 --每一个澄清都有助于某人

______________________________________________________________________

Built by Agentra Labs