Agent互操作运行时
您的编码代理已经知道如何工作，代理互操作运行时可以帮助它们共享任务，同时每个代理都保持自己的身份、帐户和工作环境。
将本地MCP客户端连接到运行时，它将找到安装在计算机上的编码代理，因此您可以选择会话，将其发送工作，跟踪其进度并将结果传递给另一个会话。每个提供者仍然使用自己的帐户、权限、历史记录和项目访问权限，因此运行时可以协调工作，而无需合并单独的环境。
可以将其视为编码代理的流量台，因为它显示哪个会话接收了任务，记录提供者发回的更新，并将每个检查的结果保存在一个地方，而不会将单独的对话转换为共享聊天。
这些图片是插图，因此它们解释了工作流程和可用的度量，但不显示实时的提供者会话。
当你发送工作时发生了什么
运行时将您的消息发送到您选择的提供者会话，并且收据可能确认提供者接受了它；然而，接受只是确认交付给提供商，并不意味着代理完成了任务。运行时只有在观察到该会话的结果后才报告完成情况。
同样的规则也适用于传递不确定的情况，因为网络故障可能发生在提供者接受您的消息之后，但在运行时收到确认之前。在这种情况下，运行时将交付标记为未知，并且不会再次静默地发送提示，从而避免重复可能已经在进行的工作。
它能做什么
在计算机上查找受支持的提供程序会话，以便在选择将工作发送到何处之前查看可用的本地工具。
当选定的提供程序支持这些操作时，创建或恢复会话，并使用提供程序报告检查设置中可用的控件。
发送工作、请求取消、读取进度和收集提供程序差异（当所选提供程序支持这些特性时）。
保持共享工作笔记、交接、证据、审查和合作资源声明，以便参与会议可以围绕同一任务进行协调。
当显式启用验证时，在指定的工作空间内运行本地检查，并在将配置的程序委托给项目之前检查它们。
读取已批准的项目文件夹中的小文本文件，同时阻止普通凭证文件，对凭证形状的文本进行编校，并拒绝二进制文件。
供应商的功能各不相同，因此医生报告显示每个已安装的供应商可以做什么；单独查找提供者并不能确认其登录状态或是否已准备好接受工作。
它做不到的事
它不会合并提供者帐户或历史记录，并且每个会话仍然受其提供者自己的设置的约束。
它不会绕过登录、同意提示或权限请求，因此您必须通过提供商本身完成这些步骤。
它不会让代理访问没有安装在运行运行时的计算机上的提供程序，也不会替换该提供程序自己的应用程序。
它不会沙箱命令，因为验证运行的是您配置的程序，您的帐户可以访问，所以只对您信任的工作和命令使用它。
资源声明协调使用此运行时的代理，但它们不能阻止运行时之外的其他程序编辑相同的文件。
供应商
Freebuff桌面使用其本地应用程序连接，并且在发送工作之前需要当前启动检查；Freebuff CLI使用一个托管终端会话。
OpenCode使用它的本地服务器，运行时可能在需要时在环回上启动，并且可能改变工作的请求在不确定的网络结果之后永远不会重播。每个会话仍然绑定到公开它的服务器，因此切换服务器不会静默地重定向现有工作。
Codex使用Codex应用服务器，而Claude Code和Cursor使用各自支持的代理客户端协议命令。
可用的功能取决于提供程序版本、本地设置和帐户状态，并且大多数协议检查使用模拟提供程序而不是实时会话。在依赖MCP服务器进行实时工作之前，请检查将运行MCP服务器的计算机上的提供程序。
选择客户端看到的工具
运行时从一组集中的9个工具开始，因此新的MCP连接可以查找提供者、检查和控制会话、读取事件以及取消或恢复工作，而无需加载更大的协调目录。当您的工作需要共享对话、证据、移交或Freebuff特定控件时，您可以选择更大的集合，并且可以保留原始的0.3。在迁移现有客户端时使用X名称。
| 配置文件 | 工具 | 使用它 |
|---|---|---|
minimal | 9 | 您需要提供程序会话的推荐启动集。 |
core | 30. | 您还需要共享对话、工作记录、交接、审查、证据和索赔。 |
freebuff | 16 | 您主要使用Freebuff项目和线程。 |
full | 49 | 您需要为每个受支持的特性使用现代名称。 |
legacy | 52 | 现有的MCP客户机仍然调用原来的0.3。X工具名称。 |
现代概要文件使用可预测的动词名，并且相关的进度操作已经组合在一起，因此一个工具可以读取快照或等待更新。遗留概要文件在迁移期间保留以前的名称，而 迁移指南 将每个旧工具映射到它的新名称或替代品。
在服务器命令或设置上选择一个配置文件 INTEROP_TOOLS_PROFILE 当客户端配置不能传递参数时。
npx -y [email protected] serve --profile minimal
npx -y [email protected] serve --profile core
npx -y [email protected] serve --profile freebuff
npx -y [email protected] serve --profile full
npx -y [email protected] serve --profile legacy
只读模式删除更改提供程序或协调状态的工具，并且可以通过设置启用 INTEROP_READ_ONLY=1 在服务器环境中。
安装
使用Node 20到Node 26，在检查哪些提供商可用之前，先用npm或pnpm安装当前的主要版本。
npm install --global agent-interop-runtime@1
agent-interop-runtime doctor
当你改变项目时，你也可以使用源代码签出，它的构建运行与发布工作流使用的TypeScript编译器相同。
git clone https://github.com/Praket7/agent-interop-runtime.git
cd agent-interop-runtime
pnpm install
pnpm build
node dist/src/cli.js doctor
连接本地MCP客户端
运行时与安装在同一台计算机上的提供商应用程序和工具进行对话，因此推荐的连接是通过标准输入和输出的本地MCP服务器。从客户机的setup命令开始，并在更改其配置后重新启动或重新加载该客户机。
食典委
安装程序添加或修复本地Codex条目，在更改现有配置之前备份现有配置，并保留不相关的设置。
npx -y [email protected] install --write
光标
Cursor安装程序在用户配置中写入与项目无关的条目，并且 --project 仅在当前项目中需要连接时可以添加。
npx -y [email protected] cursor-setup --write
克劳德代码
Claude Code可以直接启动本地服务器，下面的命令从推荐的9个工具开始。
claude mcp add --transport stdio agent-interop-runtime -- npx -y agent-interop-runtime@1 serve --profile minimal
OpenCode
将以下条目添加到OpenCode配置中，本地进程将公开相同的聚焦工具集。
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"agent-interop-runtime": {
"type": "local",
"command": ["npx", "-y", "agent-interop-runtime@1", "serve", "--profile", "minimal"],
"enabled": true
}
}
}
其他MCP客户端也可以启动相同的程序 serve 命令，并且提供程序应用程序必须在运行运行时的计算机上可用。HTTP模式可以支持有意的远程设置，但它需要身份验证和网络保护，因为会话标识符不能取代访问控制。
现有的证据
自动化测试和离线基准测试使用模拟的供应商来检查工具的行为，这些结果不需要联系实时代理、测量速度或估计供应商成本。GitHub CI针对四种支持的Node版本检查三种操作系统，共有十二种组合。
早期的本地检查观察到Freebuff GLM 5.3 Flash的响应，而OpenCode Big Pickle接受了一个提示，尽管在该会话中没有观察到完成。这些观察结果仅适用于所测试的特定会话，因此不能确定一般的提供者支持。
运行检查
pnpm typecheck
pnpm test
pnpm lint
pnpm mcp:validate
pnpm schema:check
pnpm bench:check
pnpm audit --prod --audit-level=high
npm audit --prefix media/remotion --audit-level=high
pnpm pack:check
读 提供者指南， 简单语言架构指南， 兼容性说明， 1.0迁移指南, 故障排除 查看设置和行为细节。
安全和隐私
本地标准输入和输出服务器是最简单的设置，而HTTP模式在默认情况下绑定到环回，并且需要一个承载令牌。远程访问需要显式设置和网络保护，因为会话标识符不能取代身份验证。
项目文件读取将保留在选定的项目文件夹中，并且在根据公共凭据模式检查文本时拒绝公共凭据文件。这些检查不能检测到每个秘密，所以要将敏感值从代理可以读取的文件中删除。
默认情况下，验证是关闭的，但是当启用时，它会在没有shell的情况下运行配置的程序，并检查工作文件夹是否留在指定的工作区中。子程序没有沙盒，因此它们保留您帐户授予的访问权限。
帮助改善它
使用 doctor 在发送工作之前和报告问题时，包括提供程序名称、版本、操作系统、尝试的操作以及提供程序是否接受任务或返回已完成的结果。在报告中保留私有提示和凭据。
该项目欢迎可重复的兼容性报告和代码贡献，特别是当它们解释了特定的提供程序版本和计算机上发生的事情时。