@claudexor/cli 3.25.1 → 4.0.0

package/dist/plugin-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-runtime.js","sourceRoot":"","sources":["../src/plugin-runtime.ts"],"names":[],"mappings":"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"}

package/dist/plugins.d.ts

@@ -1,3 +1,4 @@
+import type { ExternalHostBinding } from "@claudexor/schema";
 export type PluginHost = "cursor" | "claude" | "codex" | "opencode";
 export type PluginTarget = PluginHost | "all";
 export type PluginVerb = "install" | "status" | "doctor" | "repair" | "uninstall";
@@ -34,6 +35,7 @@ export interface PluginCommandErrorResult {
     error: string;
 }
 export interface PluginCommandOptions {
+    hostBinding?: ExternalHostBinding;
     dryRun?: boolean;
     force?: boolean;
     json?: boolean;

package/dist/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAClF,MAAM,MAAM,kBAAkB,GAC5B,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E,eAAO,MAAM,YAAY,EAAE,UAAU,EAA8C,CAAC;AACpF,eAAO,MAAM,cAAc,EAAE,YAAY,EAA6B,CAAC;AACvE,eAAO,MAAM,YAAY,EAAE,UAAU,EAA2D,CAAC;AAkEjG,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,EAAE,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAysDD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAsB9B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAWtE;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,wBAAwB,CAU1B"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAa7D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAClF,MAAM,MAAM,kBAAkB,GAC5B,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E,eAAO,MAAM,YAAY,EAAE,UAAU,EAA8C,CAAC;AACpF,eAAO,MAAM,cAAc,EAAE,YAAY,EAA6B,CAAC;AACvE,eAAO,MAAM,YAAY,EAAE,UAAU,EAA2D,CAAC;AA2DjG,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,EAAE,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA2hDD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA2F9B;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAWtE;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,wBAAwB,CAU1B"}

package/dist/plugins.js

@@ -1,15 +1,16 @@
-import { spawn } from "node:child_process";
-import { copyFileSync, existsSync, lstatSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, writeFileSync, } from "node:fs";
-import { dirname, isAbsolute, join, relative, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { mcpSelfTest } from "./plugin-mcp.js";
+import { copyFileSync, existsSync, lstatSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync, } from "node:fs";
+import { dirname, isAbsolute, join, relative } from "node:path";
 import { hostFallbackExamples, recoveryVerbs } from "./command-registry.js";
 import { manageClaudeStatusline } from "./claude-statusline.js";
-import { CLAUDEXOR_VERSION, defaultUserConfigDir, ensureDir, sha256, userConfigDir, userHomeDir, writeJson, } from "@claudexor/util";
+import { CLAUDEXOR_VERSION, ensureDir, sha256, userConfigDir, userHomeDir, writeJson, } from "@claudexor/util";
+import { HOST_PLUGIN_MARKER, bindingFromMcpEntry, generatedMcpEnv, launchCommand, launchShellCommand, parseHostBinding, runtimePaths, } from "./plugin-runtime.js";
+import { CliError } from "./cli-error.js";
 export const PLUGIN_HOSTS = ["cursor", "claude", "codex", "opencode"];
 export const PLUGIN_TARGETS = [...PLUGIN_HOSTS, "all"];
 export const PLUGIN_VERBS = ["install", "status", "doctor", "repair", "uninstall"];
 const STATE_VERSION = 1;
-const MARKER = "claudexor:managed host-plugin-lifecycle";
+const MARKER = HOST_PLUGIN_MARKER;
 const MCP_NAME = "claudexor";
 function managedComment(kind = "md") {
     return kind === "js"
@@ -19,30 +20,13 @@ function managedComment(kind = "md") {
 function jsonText(value) {
     return JSON.stringify(value, null, 2) + "\n";
 }
-function generatedMcpEnv(runtime) {
-    const env = {
-        CLAUDEXOR_MANAGED: MARKER,
-        CLAUDEXOR_PLUGIN_VERSION: CLAUDEXOR_VERSION,
-    };
-    // A DEFAULT-root install serializes NO config root: every generation of the
-    // CLI self-selects its own versioned default at serve time, so a stale
-    // artifact can never freeze a newer runtime onto an older data root
-    // (2026-07-21 incident: a 1.0.0 artifact drove 3.0.2 code against the v1
-    // root). An EXPLICIT operator override stays serialized WITH a provenance
-    // marker so the serve-time skew check can tell an intentional override from
-    // a legacy frozen root.
-    if (resolve(runtime.configDir) !== resolve(defaultUserConfigDir())) {
-        env.CLAUDEXOR_CONFIG_DIR = runtime.configDir;
-        env.CLAUDEXOR_ROOT_MODE = "explicit";
-    }
-    return env;
-}
 function mcpServers(runtime) {
+    const [command, ...args] = launchCommand(runtime);
     return {
         mcpServers: {
             [MCP_NAME]: {
-                command: runtime.nodePath,
-                args: [runtime.cliPath, "mcp", "serve"],
+                command,
+                args: [...args, "mcp", "serve"],
                 env: generatedMcpEnv(runtime),
             },
         },
@@ -51,7 +35,7 @@ function mcpServers(runtime) {
 function opencodeMcpEntry(runtime) {
     return {
         type: "local",
-        command: [runtime.nodePath, runtime.cliPath, "mcp", "serve"],
+        command: [...launchCommand(runtime), "mcp", "serve"],
         environment: generatedMcpEnv(runtime),
         enabled: true,
         timeout: 5000,
@@ -65,18 +49,9 @@ function recoveryVerbLine() {
         ? `${parts.slice(0, -1).join(", ")}, or ${parts[parts.length - 1]}`
         : (parts[0] ?? "");
 }
-/** POSIX single-quote shell quoting for safely copied runtime paths. */
-function shellQuote(value) {
-    return `'${value.replaceAll("'", "'\\''")}'`;
-}
-/** QA-029B: validated bundled Node + CLI prefix, never a PATH-dependent bare command. */
-function absoluteCliPrefix(runtime) {
-    return `${shellQuote(runtime.nodePath)} ${shellQuote(runtime.cliPath)}`;
-}
-/** Make registry fallback templates executable with the validated absolute CLI prefix. */
+/** CLI fallbacks share the MCP launch binding, including root and lifecycle. */
 function hostFallbackCommands(runtime) {
-    const prefix = absoluteCliPrefix(runtime);
-    return hostFallbackExamples().map((example) => example.replace(/^claudexor\b/, () => prefix));
+    return hostFallbackExamples().map((example) => launchShellCommand(runtime, example.replace(/^claudexor\s+/, "")));
 }
 /** Exact Claude plugin skill invocation; plain `/claudexor` is not an alias (QA-029A). */
 const CLAUDE_SLASH_COMMAND = "/claudexor:claudexor";
@@ -110,6 +85,7 @@ function skillText(host, runtime) {
         "",
         "When the host cannot call MCP tools, ask the user to run the local CLI explicitly (these are the exact executable commands for this install — not a bare `claudexor`, which may not be on the terminal PATH):",
         "",
+        ...(process.platform === "win32" ? ["Run these commands in PowerShell:"] : []),
         ...hostFallbackCommands(runtime).map((command) => `\`${command}\``),
         "",
         MCP_RUN_HANDLE_GUIDANCE,
@@ -154,6 +130,7 @@ function commandText(host, runtime) {
         "",
         "First prefer the available MCP tools named `claudexor_*`. If MCP tools are unavailable, tell the user the exact executable local CLI command to run (absolute paths for this install — never a bare `claudexor`, which may not be on the terminal PATH), such as:",
         "",
+        ...(process.platform === "win32" ? ["Run these commands in PowerShell:"] : []),
         ...hostFallbackCommands(runtime).map((command) => `- \`${command.replace('"..."', '"$ARGUMENTS"')}\``),
         "",
         MCP_RUN_HANDLE_GUIDANCE,
@@ -255,7 +232,7 @@ function manifest(kind) {
 }
 function opencodePluginText(runtime) {
     const hint = "Use Claudexor MCP tools or run `claudexor plan/agent/best-of` when cross-harness orchestration, review, or evidence-backed execution is useful.";
-    return `${managedComment("js")}export const ClaudexorPlugin = async () => {\n  const hint = ${JSON.stringify(hint)};\n  return {\n    \"experimental.chat.system.transform\": async (_input, output) => {\n      if (!output || typeof output !== \"object\") return;\n      const current = typeof output.system === \"string\" ? output.system : typeof output.prompt === \"string\" ? output.prompt : \"\";\n      if (current.includes(\"Claudexor\")) return;\n      if (typeof output.system === \"string\") output.system = output.system + \"\\n\\n\" + hint;\n      else if (typeof output.prompt === \"string\") output.prompt = output.prompt + \"\\n\\n\" + hint;\n    },\n  };\n};\n\nexport default ClaudexorPlugin;\n\n// OpenCode hook note: uses experimental.chat.system.transform because OpenCode does not expose tui.prompt.append as a plugin hook.\n// MCP command: ${runtime.nodePath} ${runtime.cliPath} mcp serve\n`;
+    return `${managedComment("js")}export const ClaudexorPlugin = async () => {\n  const hint = ${JSON.stringify(hint)};\n  return {\n    \"experimental.chat.system.transform\": async (_input, output) => {\n      if (!output || typeof output !== \"object\") return;\n      const current = typeof output.system === \"string\" ? output.system : typeof output.prompt === \"string\" ? output.prompt : \"\";\n      if (current.includes(\"Claudexor\")) return;\n      if (typeof output.system === \"string\") output.system = output.system + \"\\n\\n\" + hint;\n      else if (typeof output.prompt === \"string\") output.prompt = output.prompt + \"\\n\\n\" + hint;\n    },\n  };\n};\n\nexport default ClaudexorPlugin;\n\n// OpenCode hook note: uses experimental.chat.system.transform because OpenCode does not expose tui.prompt.append as a plugin hook.\n// MCP command: ${launchShellCommand(runtime, "mcp serve")}\n`;
 }
 const HOST_DEFINITIONS = {
     claude: {
@@ -283,6 +260,7 @@ const HOST_DEFINITIONS = {
                 },
                 {
                     path: join(root, ".mcp.json"),
+                    mcp: true,
                     content: jsonText(mcpServers(runtime)),
                     description: "Claude MCP config",
                 },
@@ -323,6 +301,7 @@ const HOST_DEFINITIONS = {
                 },
                 {
                     path: join(root, ".mcp.json"),
+                    mcp: true,
                     content: jsonText(mcpServers(runtime)),
                     description: "Codex MCP config",
                 },
@@ -369,6 +348,7 @@ const HOST_DEFINITIONS = {
                 },
                 {
                     path: join(root, "mcp.json"),
+                    mcp: true,
                     content: jsonText(mcpServers(runtime)),
                     description: "Cursor MCP config",
                 },
@@ -426,32 +406,6 @@ const HOST_DEFINITIONS = {
         reloadNote: "Restart OpenCode; global plugins, commands, skills, and MCP config load from ~/.config/opencode. The JS plugin uses OpenCode's experimental.chat.system.transform hook.",
     },
 };
-function runtimePaths() {
-    const home = userHomeDir();
-    const configDir = userConfigDir();
-    const warnings = [];
-    const allowTestOverrides = process.env.VITEST === "true" || process.env.NODE_ENV === "test";
-    const envNode = allowTestOverrides ? process.env.CLAUDEXOR_NODE_PATH?.trim() : undefined;
-    const bundledNode = join(home, ".claudexor", "node", "bin", "node");
-    const nodePath = envNode || (existsSync(bundledNode) ? bundledNode : process.execPath);
-    if (!isAbsolute(nodePath) || !existsSync(nodePath) || !statSync(nodePath).isFile()) {
-        throw new Error(`unable to resolve a safe Node executable for plugin MCP config: ${nodePath}`);
-    }
-    if (!envNode && nodePath !== bundledNode)
-        warnings.push(`using current node instead of ${bundledNode}`);
-    if (!allowTestOverrides && process.env.CLAUDEXOR_NODE_PATH?.trim())
-        warnings.push("ignored CLAUDEXOR_NODE_PATH outside tests");
-    const envCli = allowTestOverrides ? process.env.CLAUDEXOR_CLI_PATH?.trim() : undefined;
-    const distCli = join(dirname(fileURLToPath(import.meta.url)), "cli.js");
-    const argvCli = process.argv[1] && existsSync(resolve(process.argv[1])) ? resolve(process.argv[1]) : "";
-    const cliPath = envCli || (existsSync(distCli) ? distCli : argvCli);
-    if (!cliPath || !isAbsolute(cliPath) || !existsSync(cliPath) || !statSync(cliPath).isFile()) {
-        throw new Error("unable to resolve a safe absolute claudexor CLI entrypoint");
-    }
-    if (!allowTestOverrides && process.env.CLAUDEXOR_CLI_PATH?.trim())
-        warnings.push("ignored CLAUDEXOR_CLI_PATH outside tests");
-    return { home, configDir, nodePath, cliPath, backupStamp: safeTimestamp(), warnings };
-}
 function stateFilePath(configDir = userConfigDir()) {
     return join(configDir, "plugins", "state.json");
 }
@@ -477,6 +431,10 @@ function loadState(configDir = userConfigDir()) {
     }
     const state = parsed;
     state.hosts ??= {};
+    for (const entry of Object.values(state.hosts)) {
+        if (entry?.binding !== undefined)
+            entry.binding = parseHostBinding(entry.binding);
+    }
     return state;
 }
 function saveState(state, configDir = userConfigDir()) {
@@ -780,9 +738,6 @@ function isLegacyOwned(target) {
 function backupRoot(def, runtime) {
     return join(def.root(runtime.home), ".claudexor-backups", runtime.backupStamp);
 }
-function safeTimestamp() {
-    return new Date().toISOString().replace(/[:.]/g, "-");
-}
 function backupFile(def, runtime, path) {
     assertSafeLeaf(path);
     const dest = join(backupRoot(def, runtime), relative(runtime.home, path));
@@ -1276,117 +1231,6 @@ function removeVerifiedLegacy(def, dryRun, res) {
     }
     return true;
 }
-async function mcpSelfTest(runtime) {
-    return await new Promise((resolve) => {
-        const child = spawn(runtime.nodePath, [runtime.cliPath, "mcp", "serve"], {
-            cwd: process.cwd(),
-            env: mcpSelfTestEnv(runtime),
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-        let stdout = "";
-        let pending = "";
-        const lines = [];
-        let stderr = "";
-        let sentToolsList = false;
-        let settled = false;
-        const timer = setTimeout(() => {
-            settled = true;
-            child.kill("SIGKILL");
-            resolve("MCP self-test timed out");
-        }, 5000);
-        child.stdout.on("data", (d) => {
-            if (settled)
-                return;
-            const chunk = String(d);
-            stdout += chunk;
-            pending += chunk;
-            const frames = pending.split("\n");
-            pending = frames.pop() ?? "";
-            try {
-                for (const frame of frames.filter(Boolean))
-                    lines.push(JSON.parse(frame));
-                const init = lines.find((line) => line && typeof line === "object" && line.id === 1);
-                if (init?.result?.serverInfo?.name && !sentToolsList) {
-                    sentToolsList = true;
-                    child.stdin.write(JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized", params: {} }) +
-                        "\n");
-                    child.stdin.write(JSON.stringify({ jsonrpc: "2.0", id: 2, method: "tools/list", params: {} }) + "\n");
-                }
-                const tools = lines.find((line) => line && typeof line === "object" && line.id === 2);
-                if (tools && !settled) {
-                    settled = true;
-                    const listed = tools.result?.tools;
-                    clearTimeout(timer);
-                    child.kill("SIGTERM");
-                    if (Array.isArray(listed) &&
-                        listed.some((t) => t.name === "claudexor_status")) {
-                        resolve(null);
-                    }
-                    else {
-                        resolve("MCP self-test returned an unexpected tools-list response");
-                    }
-                }
-            }
-            catch (err) {
-                if (!settled && stdout.includes("\n")) {
-                    settled = true;
-                    clearTimeout(timer);
-                    child.kill("SIGTERM");
-                    resolve(`MCP self-test response parse failed: ${err instanceof Error ? err.message : String(err)}`);
-                }
-            }
-        });
-        child.stderr.on("data", (d) => {
-            stderr += String(d);
-        });
-        child.on("error", (err) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            resolve(`MCP self-test failed to start: ${err.message}`);
-        });
-        child.on("exit", (code) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            if (!stdout)
-                resolve(`MCP self-test exited before response (${code ?? "signal"}): ${stderr.trim()}`);
-            else
-                resolve(`MCP self-test exited before tools-list completed (${code ?? "signal"}): ${stderr.trim()}`);
-        });
-        child.stdin.write(JSON.stringify({
-            jsonrpc: "2.0",
-            id: 1,
-            method: "initialize",
-            params: {
-                protocolVersion: "2025-06-18",
-                capabilities: {},
-                clientInfo: { name: "claudexor-plugin-doctor", version: CLAUDEXOR_VERSION },
-            },
-        }) + "\n");
-    });
-}
-function mcpSelfTestEnv(runtime) {
-    const env = {};
-    for (const key of [
-        "HOME",
-        "PATH",
-        "CLAUDEXOR_CONFIG_DIR",
-        "TMPDIR",
-        "TMP",
-        "TEMP",
-        "LANG",
-        "LC_ALL",
-    ]) {
-        const value = process.env[key];
-        if (value)
-            env[key] = value;
-    }
-    Object.assign(env, generatedMcpEnv(runtime));
-    return env;
-}
 function verbNote(def, verb) {
     if (verb === "uninstall")
         return `${def.displayName} integration removed from managed Claudexor files/config; restart the host to unload cached plugin state.`;
@@ -1526,14 +1370,78 @@ export async function runPluginCommand(verb, target, options = {}) {
         throw new Error(`unknown plugin command '${verb}'`);
     if (!PLUGIN_TARGETS.includes(target))
         throw new Error(`unknown plugin target '${target}' (expected ${PLUGIN_TARGETS.join("|")})`);
-    const runtime = runtimePaths();
-    const state = loadState(runtime.configDir);
+    if (options.hostBinding && verb !== "install" && verb !== "repair")
+        throw new CliError("usage", "--host-binding-json is supported by plugin install and repair", {
+            code: "invalid_argument",
+        });
+    const explicit = options.hostBinding === undefined ? undefined : parseHostBinding(options.hostBinding);
+    const runtime = runtimePaths(explicit);
+    const states = new Map();
+    const stateAt = (root) => {
+        let state = states.get(root);
+        if (!state) {
+            state = loadState(root);
+            states.set(root, state);
+        }
+        return state;
+    };
     const results = [];
     for (const host of targets(target)) {
-        results.push(await runHost(HOST_DEFINITIONS[host], verb, options, state, runtime));
+        const def = HOST_DEFINITIONS[host];
+        try {
+            const artifacts = def.artifacts(runtime.home, runtime);
+            const path = def.config === "opencode-mcp"
+                ? chooseOpenCodeConfigPath()
+                : artifacts.find((artifact) => artifact.mcp)?.path;
+            let source;
+            try {
+                source = path ? readJsonFile(path) : undefined;
+            }
+            catch (error) {
+                // Existing artifact ownership can repair damaged JSON, but an unrelated
+                // invocation cannot infer a lost external root from malformed bytes.
+                if (!explicit && !stateAt(runtime.configDir).hosts[host])
+                    throw error;
+            }
+            let installed;
+            try {
+                installed = bindingFromMcpEntry(def.config === "opencode-mcp" ? source?.mcp?.[MCP_NAME] : source?.mcpServers?.[MCP_NAME]);
+            }
+            catch (error) {
+                if (!explicit)
+                    throw error;
+            }
+            const priorState = stateAt(installed?.configDir ?? runtime.configDir);
+            const recorded = priorState.hosts[host]?.binding;
+            const binding = explicit ?? recorded ?? installed;
+            if (!binding &&
+                artifacts.some((artifact) => {
+                    const text = readText(artifact.path);
+                    return text?.includes(MARKER) && text.includes("CLAUDEXOR_DAEMON_OWNER='external'");
+                }))
+                throw new CliError("usage", "external host binding is missing; register it with --host-binding-json", { code: "host_binding_missing" });
+            const selected = binding ? runtimePaths(binding) : runtime;
+            if (installed && installed.configDir !== selected.configDir)
+                selected.previousConfigDir = installed.configDir;
+            const state = stateAt(selected.configDir);
+            if (state !== priorState && !state.hosts[host] && priorState.hosts[host])
+                state.hosts[host] = structuredClone(priorState.hosts[host]);
+            const res = await runHost(def, verb, options, state, selected);
+            if (installed && !recorded && !explicit)
+                res.notes.push("recovered external host binding from the installed MCP configuration");
+            if (!options.dryRun && (verb === "install" || verb === "repair") && res.ok && binding)
+                hostState(state, host).binding = binding;
+            results.push(res);
+            if (!options.dryRun && (verb === "install" || verb === "repair" || verb === "uninstall"))
+                saveState(state, selected.configDir);
+        }
+        catch (error) {
+            const res = initialResult(def, verb, runtime);
+            res.state = "blocked";
+            res.errors.push(error instanceof Error ? error.message : String(error));
+            results.push(res);
+        }
     }
-    if (!options.dryRun && (verb === "install" || verb === "repair" || verb === "uninstall"))
-        saveState(state, runtime.configDir);
     const result = {
         verb,
         target,