我现在正在全职将 Executor 打造成一个创业项目！当前工具调用的状态一团糟：

• 每个人都在使用不同的 Agent
• 你完全不知道会执行哪些操作
• 破坏性操作和普通操作被一视同仁

Executor 让你只需配置一次，即可与任何 Agent 配合使用。你可以控制哪些工具可以被调用，对破坏性操作要求审批，并邀请团队成员共同使用。底层基于 codemode 构建，让你能以零上下文膨胀的方式添加数千个工具。

我已经用了一个月，它彻底改变了我与 Agent 交互的方式。这里还有太多可以构建的东西，路线图上紧接着的是工作区、技能、工作流和生成式 UI。

一切都在开源构建中：https://github.com/RhysSullivan/executor……还有更多内容即将推出，包括用于嵌入到自己 Agent 中的 SDK、可自托管的云应用以及插件支持。

早期测试版现已上线：http://executor.sh。目前还非常早期——如果遇到任何 bug 请告诉我，我会及时修复。期待在构建过程中分享更多内容！

RhysSullivan/executor

来源：https://github.com/RhysSullivan/executor

executor

https://github.com/user-attachments/assets/11225f83-e848-42ba-99b2-a993bcc88dad

AI Agent 的集成层。一个统一的工具目录，在你使用的所有 Agent 之间共享。

查看 DeepWiki（https://deepwiki.com/RhysSullivan/executor）

快速开始

npm install -g executor
executor web

这将启动一个本地运行时，并在 http://127.0.0.1:4788 提供 Web UI。在那里添加你的第一个数据源并开始使用工具。

作为 MCP 服务器使用

将任何兼容 MCP 的 Agent（Cursor、Claude Code、OpenCode 等）指向 Executor，即可在所有 Agent 之间共享工具目录、认证和策略。

executor mcp

Claude Code / Cursor 的示例 mcp.json：

{
  "mcpServers": {
    "executor": {
      "command": "executor",
      "args": ["mcp"]
    }
  }
}

添加数据源

只要能用 JSON Schema 表示，就可以作为集成接入。Executor 原生支持 OpenAPI、GraphQL、MCP 和 Google Discovery——插件系统同样对任何数据源类型开放。

通过 Web UI

打开 http://127.0.0.1:4788，进入添加数据源，粘贴一个 URL，Executor 会自动检测类型、索引工具并处理认证。

通过 CLI

executor call openapi addSource '{
  "spec": "https://petstore3.swagger.io/api/v3/openapi.json",
  "namespace": "petstore",
  "baseUrl": "https://petstore3.swagger.io/api/v3"
}'

当 OpenAPI 文档中的 servers 条目为相对路径时（例如 "/api/v3"），请使用 baseUrl。

使用工具

Agent 通过类型化的 TypeScript 运行时发现并调用工具：

// 按意图发现工具
const matches = await tools.discover({ query: "github issues", limit: 5 });

// 查看 schema
const detail = await tools.describe.tool({
  path: matches.bestPath,
  includeSchemas: true,
});

// 带类型安全地调用
const issues = await tools.github.issues.list({
  owner: "vercel",
  repo: "next.js",
});

通过 CLI 使用工具：

executor tools search "send email"
executor call --help
executor call github --help
executor call github issues --help
executor call cloudflare --help --match dns --limit 20
executor call github issues create '{"owner":"octocat","repo":"Hello-World","title":"Hi"}'
executor call gmail send '{"to":"[email protected]","subject":"Hi"}'

executor call、executor resume 和 executor tools ... 命令在需要时会自动启动本地守护进程。如果默认端口被占用，CLI 会自动选择一个可用的本地端口并自动追踪。

如果某次执行因认证或审批而暂停，可以恢复它：

executor resume --execution-id exec_123

CLI 参考

executor web                          # 启动运行时 + Web UI
executor daemon run                   # 在后台启动持久本地守护进程
executor daemon status                # 显示守护进程状态
executor daemon stop                  # 停止守护进程
executor daemon restart               # 重启守护进程
executor mcp                          # 启动 MCP 端点
executor call <路径段> '{"k":"v"}'    # 按路径段调用工具
executor call --help                  # 浏览命名空间/资源/方法
executor call --help --match "<关键词>" --limit <数量>  # 缩小大型命名空间的搜索范围
executor resume --execution-id <id>   # 恢复暂停的执行
executor tools search "<查询>"        # 按意图搜索工具
executor tools sources                # 列出已配置的数据源及工具数量
executor tools describe <路径>        # 显示工具的 TypeScript/JSON schema

本地开发

bun install
bun dev

开发服务器启动于 http://127.0.0.1:4788。

社区

加入 Discord：https://discord.gg/eF29HBHwM6

了解更多

访问 executor.sh（https://executor.sh）了解更多信息。

致谢

• 感谢 Crystian（https://www.linkedin.com/in/crystian/）提供了 npm 包名 executor。

参考资料

在我的编码过程中，我会让 Agent 访问其他代码库的参考资料，以理解相关模式以及他人是如何实现这些系统的。以下是一份不完整的参考列表：

• Better Auth（https://github.com/better-auth/better-auth）- 存储适配器参考
• Effect（https://github.com/Effect-TS/effect）- 通用代码模式
• OpenCode（https://github.com/anomalyco/opencode）- 插件系统参考
• OpenClaw（https://github.com/openclaw/openclaw）- 插件系统参考
• Emdash（https://github.com/emdash-cms/emdash）- 插件系统参考
• Pi（https://github.com/badlogic/pi-mono）- 插件系统参考

同样欢迎你将本代码库作为参考，以了解其实现方式。