Agent Relay

项目简介

Agent Relay 是一个开源工具包，为工程团队提供让编码代理协同工作的基础设施，同时不替换团队已经在用的代理和工具。它把消息、集成、共享会话和可强制执行的工作流组合起来，覆盖代理、人员、工具和机器。

核心功能

• 消息：代理可通过共享频道、线程、私信、文件、搜索和实时事件直接沟通，即使运行在不同机器上也能在同一工作区协调。集成：GitHub、Linear、Notion、Slack 等工具以虚拟文件系统方式提供，代理可用 ls、cat、grep 和普通文件写入来操作。共享会话：捕获编码代理会话，让团队及其代理可搜索过往工作、决策和上下文。Flows：把希望代理遵循的指令变成 TypeScript 定义的多步骤工作流，带确定性检查、必需步骤和人工关卡。前向部署代理可获得公开地址，并选择性地与其他代理通信。兼容现有工具，包括终端代理、桌面应用和手机上的代理，无需更换

适用场景

• 让前端代理和后端代理直接互相查询，并在分支冲突时由两个代理解决合并冲突，而不是每一步交接都经过人。跨团队成员和代理共享可搜索的会话历史，让决策不再只留在某个聊天里。把笔记本电脑、云主机和不同时区的代理协调在同一工作区。用 Flows 通过确定性检查和人工关卡来强制执行多步骤代理工作流。

快速开始

• 可使用 Agent Relay Cloud 探索各项能力，无需信用卡，也无需先搭建基础设施。按推荐方式运行安装脚本，或运行 npm install -g agent-relay，然后在项目中运行 relay init。relay init 会在本机启动一个无需账户的私有服务器，查找已安装的编码代理（如 Claude Code、Codex、OpenCode、Grok CLI、Pi、Devin），并把 Relay 添加到这些代理。安装桌面应用并登录，源材料称大约 10 分钟可完成第一次交接。

部署与要求

• 可使用托管的 Agent Relay Cloud，也可在自己的服务器上运行开源 relay。安装脚本会把所有 Agent Relay 二进制文件放到 ~/.agentworkforce/relay/bin；可通过 AGENT_RELAY_INSTALL_DIR 或 AGENT_RELAY_HOME 调整安装目录，二进制文件随后位于其 bin/ 下。npm 安装的 CLI 会链接到 npm 的全局 bin 目录（$(npm prefix -g)/bin），而不是 ~/.agentworkforce/relay/bin；首次运行只把

采用前须知

• 许可证：Apache-2.0。在使用、修改或分发项目前，请确认其具体条款。