agentsCommunication Community

让 DSH、Codex 和 Claude 的本机会话直接协作，省去人在不同客户端之间复制粘贴。

非官方社区项目，与 DeepSeek、OpenAI、Anthropic 无隶属或背书关系。MIT 开源，当前为 community-v0.1.0 预览版。

看一个例子

DSH 正在整理报告，希望 Claude Code 检查一段代码。它可以找到目标会话、发送独立可理解的任务、等待回执，再读取一次性返回的结果。Codex 同样可以与其他 harness 协作。

消息中心把“已排队”和“已处理”分开，让发送方知道任务进行到了哪里：

图中内容、会话地址和处理结果均为模拟数据。 截图使用真实界面与隔离数据目录，不连接实际模型，不代表一次生产会话端到端测试。

Related MCP server: openswarm

能做什么

• list_agents：按标题、客户端和目录找到本机会话。

• followup_task：发送任务，支持的目标可开始新一轮，完成后回传一次结果。

• send_message：仅投递信息，不主动开始新一轮。

• wait_agent / read_agent：等待状态变化、读取已有记录。

• spawn_agent：通过已安装 CLI 新建 Codex 或 Claude Code 会话；不支持新建 DSH 或 Claude Desktop 普通聊天。

• 持久消息与回执、显式附带上下文或文件、重试去重、一次性回复防循环。

• MCP 工具、命令行、本地管理界面，以及随包使用 SOP。

同一个 harness 内，如果已有能到达目标的原生协作工具，应优先用原生工具。例如 Codex 独立聊天间存在 send_message_to_thread 时直接使用它。本工具主要用于跨 harness。

快速开始

需要 Node.js 24+，以及你希望连接的客户端/CLI。Windows 是当前测试环境，其他系统尚未做完整验收。DSH 会话压缩日志读取依赖 Node 的 zstd 支持。

从 Releases 下载包，或克隆此仓库：

git clone https://github.com/Myoontyee/agentsCommunication-community.git
cd agentsCommunication-community
node bin/agentscomm.js ui

Windows 也可以双击 start.cmd。程序没有需要安装的第三方运行依赖。

在需要连接的客户端页签中，选择安装“标准 MCP”和“标准 SOP”。Claude Code 接收即时消息还需要对应的 receiver mod。配置写入前会备份；配置何时生效取决于客户端的 MCP 重载能力。

随后可以请求 Agent：

找到 Claude Code 中的“接口检查”会话，请它核对示例项目的参数校验，把结果回给当前 DSH 会话。

先核对目标地址，再发送具体任务。CLI 的占位符必须替换为实际发现的会话 ID：

node bin/agentscomm.js peers --harness claude-code
node bin/agentscomm.js send --from dsh:<source-session-id> --to claude-code:<target-session-id> "请检查示例项目的参数校验，返回结论及文件位置。"
node bin/agentscomm.js status <message-id>

DSH 集成

DSH 通过 MCP 使用发送工具；接收侧使用其 dsh-communication 端点，读取当前用户自己的 connection 与 credential 文件。不会附带开发者的凭据。

node bin/agentscomm.js dsh status
node bin/agentscomm.js dsh targets

目标必须已存在，并获得 DSH 允许。需要添加目标时，用户明确确认后执行 agentscomm dsh allow <session-id>。安装本工具不自动扩大目标白名单。

不同客户端的接收边界

queued、routed、delivered 不等于处理完成，只有相应的终态与回复才能说明结果。支持进度通知的 MCP 宿主可以显示实时进展，其他宿主只收到最终状态，见 进度契约。

数据与权限

消息、附件、回执、导入记录、配置和备份保存在当前用户的 .agentsCommunication 目录。管理界面只监听本机回环地址。软件是本地协作桥，不是远程设备组网服务；接收方模型的云端数据政策仍然适用。

安装器会按用户选择写入客户端 MCP/技能配置。消息内容、附带文件和对话历史可能敏感，只发给已授权目标。发送方标识是工具报告的身份，不是额外的身份认证；另一 Agent 的消息也不是用户授予新权限的凭证。CLI 执行可能消耗对应模型额度。

新公开版与其他版本使用相同的运行数据目录和 MCP 名称。不要同时启动两个版本；试用可用 AGENTSCOMM_HOME 指定独立数据目录。不要把运行数据目录、客户端配置、凭据、真实截图或日志提交到仓库。

开发与验证

npm test
npm pack --dry-run

首次公开快照通过 59 项测试（Windows / Node 24.14），使用隔离目录、假 CLI 和本地协议端点。它们验证调用链与错误处理，不等同于所有真实客户端/模型组合均已通过。发布截图的复现脚本见 示例说明。

完整调用和恢复说明见 agentscommunication SOP。本地界面布局参考 cc-switch 的客户端切换方式；相关商标归各自所有者。