@spawn-dock/create 0.2.0-canary.20260321111558.f5e5655 → 0.2.3

package/README.md

@@ -29,7 +29,6 @@ npx --yes github:SpawnDock/create#main --token <pairing-token> [project-dir]
 - `spawndock.config.json`
 - `.env.local`
 - `spawndock.dev-tunnel.json`
-- `opencode.json`
 - `public/tonconnect-manifest.json`
 
 ## Built-in Overlay
@@ -40,11 +39,20 @@ The package also ships a built-in TMA overlay and applies it after cloning
 - `spawndock/dev.mjs`
 - `spawndock/next.mjs`
 - `spawndock/tunnel.mjs`
+- `spawndock/mcp.mjs`
+- `opencode.json`
+- `.mcp.json`
 - `next.config.ts`
 - `public/tonconnect-manifest.json`
 - patching project scripts and `@spawn-dock/dev-tunnel`
 
-Generated MCP config points to `<controlPlaneUrl>/mcp/sse`.
+`spawndock/mcp.mjs` resolves `<controlPlaneUrl>/mcp/sse` from
+`spawndock.config.json`.
+
+- `opencode.json` is shipped by the template for OpenCode.
+- `.mcp.json` is shipped by the template for Claude Code.
+- if `codex` is installed locally, bootstrap also registers the same MCP server in
+  the global Codex MCP config automatically.
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spawn-dock/create",
-  "version": "0.2.0-canary.20260321111558.f5e5655",
+  "version": "0.2.3",
   "type": "module",
   "description": "SpawnDock bootstrap CLI for local TMA projects",
   "license": "ISC",

package/packages/app/dist/src/app/program.js

@@ -6,6 +6,7 @@ const formatSuccess = (summary) => [
     `SpawnDock project created at ${summary.projectDir}`,
     `Project: ${summary.projectName}`,
     `Preview URL: ${summary.previewOrigin}`,
+    `MCP ready for: ${summary.mcpAgents.join(", ")}`,
     `Run: cd "${summary.projectDir}" && npm run dev`,
 ].join("\n");
 const cliProgram = pipe(readCliOptions, Effect.flatMap((options) => options.token.length > 0

package/packages/app/dist/src/core/bootstrap.js

@@ -4,6 +4,7 @@ export const DEFAULT_CLAIM_PATH = "/v1/bootstrap/claim";
 export const DEFAULT_TEMPLATE_REPO = "https://github.com/SpawnDock/tma-project.git";
 export const DEFAULT_TEMPLATE_BRANCH = "master";
 export const TEMPLATE_ID = "nextjs-template";
+export const DEFAULT_MCP_AGENTS = ["OpenCode", "Claude Code"];
 export const normalizeDisplayName = (value) => value
     .split(/[^a-zA-Z0-9]+/g)
     .filter(Boolean)
@@ -30,6 +31,17 @@ export const buildMcpServerUrl = (controlPlaneUrl) => {
     url.pathname = normalizedPath.length > 0 ? `${normalizedPath}/mcp/sse` : "/mcp/sse";
     return url.toString();
 };
+export const buildCodexMcpCommandArgs = (mcpServerUrl) => [
+    "mcp",
+    "add",
+    "spawndock",
+    "--env",
+    `MCP_SERVER_URL=${mcpServerUrl}`,
+    "--",
+    "npx",
+    "-y",
+    "@spawn-dock/mcp",
+];
 export const buildTonConnectManifest = (context, claim) => `${JSON.stringify({
     url: claim.previewOrigin,
     name: context.projectName,
@@ -64,19 +76,6 @@ export const buildGeneratedFiles = (context, claim) => {
         SPAWNDOCK_PROJECT_SLUG: claim.projectSlug,
         SPAWNDOCK_ALLOWED_DEV_ORIGINS: claim.previewOrigin,
     };
-    const opencode = {
-        $schema: "https://opencode.ai/config.json",
-        mcp: {
-            spawndock: {
-                type: "local",
-                command: ["npx", "-y", "@spawn-dock/mcp"],
-                enabled: true,
-                environment: {
-                    MCP_SERVER_URL: mcpServerUrl,
-                },
-            },
-        },
-    };
     return [
         {
             path: "spawndock.config.json",
@@ -97,10 +96,6 @@ export const buildGeneratedFiles = (context, claim) => {
                 port: claim.localPort,
             }, null, 2)}\n`,
         },
-        {
-            path: "opencode.json",
-            content: `${JSON.stringify(opencode, null, 2)}\n`,
-        },
         {
             path: "public/tonconnect-manifest.json",
             content: buildTonConnectManifest(context, claim),
@@ -118,6 +113,7 @@ export const patchPackageJsonContent = (input) => {
     packageJson.devDependencies = {
         ...(packageJson.devDependencies ?? {}),
         "@spawn-dock/dev-tunnel": "latest",
+        "@spawn-dock/mcp": "latest",
     };
     return `${JSON.stringify(packageJson, null, 2)}\n`;
 };

package/packages/app/dist/src/shell/bootstrap.js

@@ -3,7 +3,7 @@ import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { dirname, join, resolve } from "node:path";
 import { Effect } from "effect";
-import { buildGeneratedFiles, patchPackageJsonContent, resolveProjectContext, } from "../core/bootstrap.js";
+import { buildCodexMcpCommandArgs, buildGeneratedFiles, buildMcpServerUrl, DEFAULT_MCP_AGENTS, patchPackageJsonContent, resolveProjectContext, } from "../core/bootstrap.js";
 const TEMPLATE_OVERLAY_DIR = resolve(fileURLToPath(new URL("../../../template-nextjs-overlay", import.meta.url)));
 export const bootstrapProject = (options) => Effect.gen(function* () {
     if (options.token.length === 0) {
@@ -24,10 +24,12 @@ export const bootstrapProject = (options) => Effect.gen(function* () {
     });
     yield* writeGeneratedFilesToProject(projectDir, context, claim);
     yield* installDependencies(projectDir);
+    const mcpAgents = yield* registerAgentIntegrations(projectDir, claim);
     return {
         projectDir,
         projectName: context.projectName,
         previewOrigin: claim.previewOrigin,
+        mcpAgents,
     };
 });
 const ensureEmptyProjectDir = (projectDir) => Effect.try({
@@ -120,6 +122,23 @@ const installDependencies = (projectDir) => Effect.gen(function* () {
     }
     yield* runCommand("pnpm", ["install"], projectDir);
 });
+const registerAgentIntegrations = (projectDir, claim) => Effect.gen(function* () {
+    const integrations = [...DEFAULT_MCP_AGENTS];
+    const mcpServerUrl = buildMcpServerUrl(claim.controlPlaneUrl);
+    const codexRegistered = yield* registerCodexIntegration(projectDir, mcpServerUrl);
+    if (codexRegistered) {
+        integrations.push("Codex");
+    }
+    return integrations;
+});
+const registerCodexIntegration = (projectDir, mcpServerUrl) => Effect.gen(function* () {
+    const codexAvailable = yield* commandExists("codex");
+    if (!codexAvailable) {
+        return false;
+    }
+    const result = yield* runCommand("codex", buildCodexMcpCommandArgs(mcpServerUrl), projectDir, false);
+    return result.status === 0;
+});
 const runCommand = (command, args, cwd = process.cwd(), failOnNonZero = true) => Effect.try({
     try: () => {
         const result = spawnSync(command, [...args], {
@@ -136,6 +155,23 @@ const runCommand = (command, args, cwd = process.cwd(), failOnNonZero = true) =>
     },
     catch: toError,
 });
+const commandExists = (command) => Effect.try({
+    try: () => {
+        const result = spawnSync(command, ["--help"], {
+            cwd: process.cwd(),
+            encoding: "utf8",
+            stdio: "ignore",
+        });
+        if (result.error) {
+            if (isNodeError(result.error) && result.error.code === "ENOENT") {
+                return false;
+            }
+            throw toError(result.error);
+        }
+        return true;
+    },
+    catch: toError,
+});
 const parseClaimResponse = (input, fallbackProjectSlug, fallbackControlPlaneUrl, fallbackLocalPort) => {
     if (!isRecord(input)) {
         return null;

package/packages/app/template-nextjs-overlay/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "spawndock": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "./spawndock/mcp.mjs"
+      ]
+    }
+  }
+}

package/packages/app/template-nextjs-overlay/opencode.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "spawndock": {
+      "type": "local",
+      "command": [
+        "node",
+        "./spawndock/mcp.mjs"
+      ],
+      "enabled": true
+    }
+  }
+}

package/packages/app/template-nextjs-overlay/spawndock/config.mjs

@@ -12,3 +12,18 @@ export const resolvePreviewOrigin = (config) =>
 
 export const resolveAllowedDevOrigins = (config) =>
   [config.previewOrigin].filter(Boolean)
+
+export const resolveMcpServerUrl = (config) => {
+  if (typeof config.mcpServerUrl === "string" && config.mcpServerUrl.length > 0) {
+    return config.mcpServerUrl
+  }
+
+  if (typeof config.controlPlaneUrl === "string" && config.controlPlaneUrl.length > 0) {
+    const url = new URL(config.controlPlaneUrl)
+    const normalizedPath = url.pathname.replace(/\/$/, "")
+    url.pathname = normalizedPath.length > 0 ? `${normalizedPath}/mcp/sse` : "/mcp/sse"
+    return url.toString()
+  }
+
+  throw new Error("Missing mcpServerUrl or controlPlaneUrl in spawndock.config.json")
+}

package/packages/app/template-nextjs-overlay/spawndock/mcp.mjs

@@ -0,0 +1,24 @@
+import { spawn } from "node:child_process"
+
+import { readSpawndockConfig, resolveMcpServerUrl } from "./config.mjs"
+
+const config = readSpawndockConfig()
+const mcpServerUrl = process.env.MCP_SERVER_URL ?? resolveMcpServerUrl(config)
+
+const child = spawn("pnpm", ["exec", "spawn-dock-mcp"], {
+  cwd: process.cwd(),
+  env: {
+    ...process.env,
+    MCP_SERVER_URL: mcpServerUrl,
+  },
+  stdio: "inherit",
+})
+
+child.on("exit", (code) => {
+  process.exit(typeof code === "number" ? code : 1)
+})
+
+child.on("error", (error) => {
+  console.error(error)
+  process.exit(1)
+})