Skip to content

Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.

feat(plugins): add local Executor MCP support (#164)

Enoch3ff3dc5c5c9c
diff --git a/apps/web/src/components/plugins/PluginsDialog.test.tsx b/apps/web/src/components/plugins/PluginsDialog.test.tsx
index a5232899f..907937954 100644
--- a/apps/web/src/components/plugins/PluginsDialog.test.tsx
+++ b/apps/web/src/components/plugins/PluginsDialog.test.tsx
@@ -252,11 +252,11 @@ describe("Plugins dialog content", () => {
);
expect(markup).toContain("By Useful Software Co.");
expect(markup).toContain("Authentication");
- expect(markup).toContain("OAuth");
- expect(markup).toContain("Hosted");
- expect(markup).toContain("Remote URL");
+ expect(markup).not.toContain("OAuth");
+ expect(markup).toContain("Local");
+ expect(markup).toContain("Local command");
expect(markup).toContain("Not checked");
- expect(markup).toContain("web, desktop, mobile");
+ expect(markup).toContain("macos, windows, linux");
expect(markup).toContain("Submit a payment.");
expect(markup).toContain("account-wide");
expect(markup).toContain("Documentation");
diff --git a/apps/web/src/components/plugins/pluginRegistry.test.ts b/apps/web/src/components/plugins/pluginRegistry.test.ts
index 9ea8bb3d2..0e25f8327 100644
--- a/apps/web/src/components/plugins/pluginRegistry.test.ts
+++ b/apps/web/src/components/plugins/pluginRegistry.test.ts
@@ -1,6 +1,6 @@
import { McpServerId, type McpServer } from "@t3tools/contracts";
import { describe, expect, it } from "vite-plus/test";
-import { loadCatalog } from "../../../../../plugins";
+import { loadCatalog, loadDirectoryCatalog, type PluginDefinition } from "../../../../../plugins";
import {
findPluginServer,
isBuiltinMcpServer,
@@ -14,6 +14,16 @@ const exa = catalog.find((plugin) => plugin.id === "exa");
const firecrawl = catalog.find((plugin) => plugin.id === "firecrawl");
if (!exa || !firecrawl) throw new TypeError("Required catalog plugins are missing.");
+const executorDirectory = loadDirectoryCatalog().find((plugin) => plugin.id === "executor");
+if (!executorDirectory || executorDirectory.kind !== "mcp-stdio") {
+ throw new TypeError("Executor is missing its local stdio recipe.");
+}
+const executor = {
+ ...executorDirectory,
+ connection: { type: "local" as const },
+ catalogStatus: "available" as const,
+} satisfies PluginDefinition;
+
const exaServer: McpServer = {
id: pluginMcpServerId(exa),
name: "Exa",
@@ -42,6 +52,31 @@ describe("plugin registry mapping", () => {
});
});
+ it("maps local Executor and refreshes its stale recipe before enabling", () => {
+ const existingExecutorServer: McpServer = {
+ id: pluginMcpServerId(executor),
+ name: "Executor",
+ transport: "stdio",
+ command: "bunx",
+ args: ["-y", "executor", "mcp"],
+ enabled: false,
+ createdAt: "2026-08-27T00:00:00.000Z",
+ updatedAt: "2026-08-27T00:00:00.000Z",
+ };
+
+ expect(pluginMcpConfiguration(executor)).toEqual({
+ name: "Executor",
+ transport: "stdio",
+ command: "executor",
+ args: ["mcp"],
+ });
+ expect(planPluginToggle(executor, [existingExecutorServer], true)).toEqual({
+ action: "refresh-and-enable",
+ mcpServerId: existingExecutorServer.id,
+ configuration: pluginMcpConfiguration(executor),
+ });
+ });
+
it("creates, refreshes, enables, and disables through the existing registry", () => {
expect(planPluginToggle(firecrawl, [exaServer], true).action).toBe("create");
expect(planPluginToggle(exa, [exaServer], true)).toEqual({
diff --git a/docs/internals/plugin-lifecycle-verification.md b/docs/internals/plugin-lifecycle-verification.md
index 74cdab97d..7d271176a 100644
--- a/docs/internals/plugin-lifecycle-verification.md
+++ b/docs/internals/plugin-lifecycle-verification.md
@@ -24,4 +24,4 @@ Run the matrix with the catalog, schema, runtime, and validator checks. Do not c
This local run did not perform a real Context.dev or Zernio connection lifecycle. Context.dev keeps its existing available identity; this run does not recertify it. Zernio stays Featured rank 2 and `verification-pending` until its OAuth and connection lifecycle passes.
-Executor now declares its official hosted OAuth endpoint, but stays pending until that lifecycle passes. Typefully stays pending until its OAuth lifecycle passes. Paper stays pending until its loopback desktop lifecycle passes. PayPal stays pending until its first-party OAuth and payment lifecycle passes. No entry can move to available based on a manifest check, HTTP probe, or vendor documentation alone.
+Executor now declares its official local stdio CLI recipe, but stays pending until its full add, use, disable, reconnect, and removal lifecycle passes. Typefully stays pending until its OAuth lifecycle passes. Paper stays pending until its loopback desktop lifecycle passes. PayPal stays pending until its first-party OAuth and payment lifecycle passes. No entry can move to available based on a manifest check, HTTP probe, or vendor documentation alone.
diff --git a/plugins/catalog.test.ts b/plugins/catalog.test.ts
index 3e34759ef..469f132a4 100644
--- a/plugins/catalog.test.ts
+++ b/plugins/catalog.test.ts
@@ -289,9 +289,12 @@ describe("plugin catalog loader", () => {
catalogStatus: "verification-pending",
});
expect(byId.get("executor")).toMatchObject({
- authentication: "oauth",
+ kind: "mcp-stdio",
+ command: "executor",
+ args: ["mcp"],
+ authentication: "none",
requiredCredentials: [],
- transport: { type: "url", url: "https://executor.sh/mcp" },
+ transport: { type: "stdio", command: "executor", args: ["mcp"] },
connection: { type: "verification-pending" },
catalogStatus: "verification-pending",
});
diff --git a/plugins/entries/executor/plugin.json b/plugins/entries/executor/plugin.json
index 81b026f07..817c52f74 100644
--- a/plugins/entries/executor/plugin.json
+++ b/plugins/entries/executor/plugin.json
@@ -2,30 +2,34 @@
"schemaVersion": 1,
"id": "executor",
"name": "Executor",
- "description": "Use the integrations configured in your Executor account.",
+ "description": "Use the integrations configured in your local Executor account.",
"primaryCategory": "Work",
- "tags": ["integrations", "automation", "hosted"],
- "capabilities": ["use configured integrations", "run integration tools"],
+ "tags": ["integrations", "automation", "local"],
+ "capabilities": ["use configured integrations", "run local integration tools"],
"publisher": { "name": "Useful Software Co.", "url": "https://executor.sh" },
"maintainer": { "name": "Useful Software Co.", "url": "https://executor.sh" },
"documentationUrl": "https://executor.sh/docs",
- "sourceUrl": "https://executor.sh/docs",
- "license": "Proprietary",
+ "sourceUrl": "https://github.com/UsefulSoftwareCo/executor",
+ "license": "MIT",
"logo": {
"provenance": {
"sourceUrl": "https://executor.sh/favicon-192.png",
"license": "Executor brand asset"
}
},
- "platforms": ["web", "desktop", "mobile"],
- "transport": { "type": "url", "url": "https://executor.sh/mcp" },
+ "platforms": ["macos", "windows", "linux"],
+ "transport": { "type": "stdio", "command": "executor", "args": ["mcp"] },
"connection": {
"type": "verification-pending",
- "blocker": "Hosted OAuth is documented, but the full add, use, disable, reconnect, and remove lifecycle still needs current verification."
+ "blocker": "The local Executor CLI recipe is documented, but the full add, use, disable, reconnect, and remove lifecycle still needs current verification."
},
- "authentication": "oauth",
+ "authentication": "none",
"requiredCredentials": [],
- "setup": ["Wait for the hosted Executor connection lifecycle to pass."],
+ "setup": [
+ "Install the Executor CLI with `npm install -g executor` on Node.js 20 or newer, and keep `executor` on PATH.",
+ "Install and start Executor with `executor install` and `executor web`, then use the local UI to add and configure the integrations you want and complete integration authentication where required.",
+ "The CLI and its configured local service must be available to the Akeru server process when it launches `executor mcp`."
+ ],
"permissions": [
{
"id": "read-integrations",
diff --git a/plugins/lifecycle-matrix.test.ts b/plugins/lifecycle-matrix.test.ts
index 420186466..7b04d7f41 100644
--- a/plugins/lifecycle-matrix.test.ts
+++ b/plugins/lifecycle-matrix.test.ts
@@ -60,8 +60,11 @@ describe("milestone 13 plugin lifecycle matrix", () => {
connection: { type: "verification-pending" },
});
expect(byId.get("executor")).toMatchObject({
- transport: { type: "url", url: "https://executor.sh/mcp" },
- authentication: "oauth",
+ kind: "mcp-stdio",
+ command: "executor",
+ args: ["mcp"],
+ transport: { type: "stdio", command: "executor", args: ["mcp"] },
+ authentication: "none",
connection: { type: "verification-pending" },
});
expect(byId.get("github")).toMatchObject({