@01.software/init 0.3.0 → 0.4.0

package/dist/index.js

@@ -1,4 +1,19 @@
 #!/usr/bin/env node
+import {
+  fetchTenantContext,
+  generateClaudeMd,
+  getSkillFiles
+} from "./chunk-SRLZ5OIV.js";
+import {
+  CODEX_MCP_SECTION_MARKER,
+  getClientTemplate,
+  getCodexMcpTomlSection,
+  getEnvContent,
+  getMcpConfigTemplate,
+  getMcpServerEntry,
+  getQueryProviderTemplate,
+  getServerTemplate
+} from "./chunk-OEAQV63E.js";
 
 // src/index.ts
 import pc3 from "picocolors";
@@ -11,12 +26,13 @@ function detectProject(cwd) {
   const hasPackageJson = fs.existsSync(pkgPath);
   let env = "node";
   let hasSdk = false;
+  let parseError = false;
   if (hasPackageJson) {
     let pkg;
     try {
       pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
     } catch {
-      return { hasPackageJson: false, parseError: true, env: "node", packageManager: null, hasSdk: false, srcDir: false };
+      return { hasPackageJson: true, parseError: true, env: "node", packageManager: null, hasSdk: false, srcDir: false };
     }
     const deps = {
       ...pkg.dependencies || {},
@@ -52,7 +68,7 @@ function detectProject(cwd) {
     packageManager = "npm";
   }
   const srcDir = env === "nextjs" ? fs.existsSync(path.join(cwd, "src", "app")) : fs.existsSync(path.join(cwd, "src"));
-  return { hasPackageJson, env, packageManager, hasSdk, srcDir };
+  return { hasPackageJson, parseError, env, packageManager, hasSdk, srcDir };
 }
 function needsClient(env) {
   return env === "nextjs" || env === "react-vite" || env === "react-cra" || env === "vanilla";
@@ -171,7 +187,7 @@ async function promptUser(hasSdk, detectedEnv, detectedPm) {
     keyPrompts.push({
       type: "text",
       name: "publishableKey",
-      message: "Client Key (optional, saved to .env)",
+      message: "Publishable Key (optional, saved to .env)",
       initial: ""
     });
   }
@@ -187,19 +203,20 @@ async function promptUser(hasSdk, detectedEnv, detectedPm) {
     {
       type: "multiselect",
       name: "selectedTools",
-      message: "Connect AI tools:",
+      message: "Connect AI tools (leave empty to skip):",
       choices: [
         { title: "Claude Code", description: ".mcp.json + .claude/ docs", value: "claude" },
         { title: "Cursor", description: ".cursor/mcp.json", value: "cursor" },
         { title: "VS Code", description: ".vscode/mcp.json", value: "vscode" },
         { title: "Windsurf", description: "~/.codeium/windsurf/mcp_config.json", value: "windsurf" },
-        { title: "Skip", value: "skip" }
+        { title: "Codex CLI", description: "~/.codex/config.toml", value: "codex" },
+        { title: "Gemini CLI", description: "~/.gemini/settings.json", value: "gemini" }
       ],
-      hint: "space to select"
+      hint: "space to select, enter to confirm"
     },
     { onCancel }
   );
-  const aiTools = Array.isArray(selectedTools) ? selectedTools.filter((t) => t !== "skip") : [];
+  const aiTools = Array.isArray(selectedTools) ? selectedTools : [];
   let authMethod = "skip";
   let keys = {};
   if (aiTools.length > 0 && env !== "vanilla") {
@@ -239,103 +256,10 @@ async function promptUser(hasSdk, detectedEnv, detectedPm) {
 // src/init.ts
 import fs2 from "fs";
 import path2 from "path";
+import os from "os";
 import { execSync } from "child_process";
 import pc2 from "picocolors";
 
-// src/templates.ts
-function getClientTemplate(env, publishableKeyEnvVar) {
-  if (env === "nextjs") {
-    return `import { createClient } from '@01.software/sdk'
-
-export const client = createClient({
-  publishableKey: process.env.${publishableKeyEnvVar}!,
-})
-`;
-  }
-  if (env === "react-cra") {
-    return `import { createClient } from '@01.software/sdk'
-
-export const client = createClient({
-  publishableKey: process.env.${publishableKeyEnvVar}!,
-})
-`;
-  }
-  if (env === "vanilla") {
-    return `import { createClient } from '@01.software/sdk'
-
-// Replace 'YOUR_PUBLISHABLE_KEY' with your actual publishable key from the 01.software console
-export const client = createClient({
-  publishableKey: 'YOUR_PUBLISHABLE_KEY',
-})
-`;
-  }
-  return `import { createClient } from '@01.software/sdk'
-
-export const client = createClient({
-  publishableKey: import.meta.env.${publishableKeyEnvVar},
-})
-`;
-}
-function getQueryProviderTemplate(env) {
-  const useClientDirective = env === "nextjs" ? "'use client'\n\n" : "";
-  return `${useClientDirective}import { QueryClientProvider } from '@tanstack/react-query'
-import { client } from './client'
-
-export function QueryProvider({ children }: { children: React.ReactNode }) {
-  return (
-    <QueryClientProvider client={client.queryClient}>
-      {children}
-    </QueryClientProvider>
-  )
-}
-`;
-}
-function getServerTemplate(env, publishableKeyEnvVar, secretKeyEnvVar) {
-  if (env === "edge") {
-    return `import { createServerClient } from '@01.software/sdk'
-
-// Edge runtime: pass your env bindings here
-// e.g. Cloudflare Workers: use env.SOFTWARE_PUBLISHABLE_KEY from the handler context
-// e.g. Vercel Edge:        use process.env.${publishableKeyEnvVar}
-export function createEdgeClient(publishableKey: string, secretKey: string) {
-  return createServerClient({ publishableKey, secretKey })
-}
-`;
-  }
-  return `import { createServerClient } from '@01.software/sdk'
-
-export const serverClient = createServerClient({
-  publishableKey: process.env.${publishableKeyEnvVar}!,
-  secretKey: process.env.${secretKeyEnvVar}!,
-})
-`;
-}
-function getEnvContent(publishableKey, secretKey, publishableKeyEnvVar, secretKeyEnvVar) {
-  let content = `
-# 01.software
-${publishableKeyEnvVar}=${publishableKey}
-`;
-  if (secretKeyEnvVar) {
-    content += `${secretKeyEnvVar}=${secretKey}
-`;
-  }
-  return content;
-}
-function getMcpServerEntry(apiKey) {
-  return {
-    type: "http",
-    url: "https://mcp.01.software/mcp",
-    headers: { "x-api-key": apiKey }
-  };
-}
-function getMcpConfigTemplate(apiKey) {
-  return JSON.stringify(
-    { mcpServers: { "01software": getMcpServerEntry(apiKey) } },
-    null,
-    2
-  ) + "\n";
-}
-
 // src/browser-auth.ts
 import { randomBytes } from "crypto";
 import { createServer } from "http";
@@ -349,7 +273,7 @@ function escapeHtml(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
 function openBrowser(url) {
-  const os = platform();
+  const os2 = platform();
   const onError = () => {
     console.log(
       pc.yellow(
@@ -358,12 +282,12 @@ ${url}`
       )
     );
   };
-  if (os === "win32") {
+  if (os2 === "win32") {
     exec(`start "" "${url}"`, (err) => {
       if (err) onError();
     });
   } else {
-    const cmd = os === "darwin" ? "open" : "xdg-open";
+    const cmd = os2 === "darwin" ? "open" : "xdg-open";
     execFile(cmd, [url], (err) => {
       if (err) onError();
     });
@@ -395,6 +319,7 @@ async function startBrowserAuth(options) {
       "Access-Control-Allow-Origin": webUrl,
       "Access-Control-Allow-Methods": "POST, OPTIONS",
       "Access-Control-Allow-Headers": "Content-Type",
+      "Access-Control-Allow-Private-Network": "true",
       "Access-Control-Max-Age": "600",
       Vary: "Origin"
     };
@@ -518,156 +443,6 @@ ${loginUrl}`));
   });
 }
 
-// src/ai-docs.ts
-function generateClaudeMd(ctx) {
-  const featuresSection = ctx.features && ctx.features.length > 0 ? ctx.features.map((f) => `- ${f}`).join("\n") : "- See console";
-  const collectionsSection = ctx.collections && ctx.collections.length > 0 ? ctx.collections.join(", ") : "Run `01 schema list`";
-  return `# 01.software SDK \u2014 ${ctx.tenantName}
-
-## Connection
-- Publishable Key: \`NEXT_PUBLIC_SOFTWARE_PUBLISHABLE_KEY\` (env)
-- Secret Key: \`SOFTWARE_SECRET_KEY\` (env)
-- MCP: \`.mcp.json\`
-
-## Active Features
-${featuresSection}
-
-## Collections
-${collectionsSection}
-
-## MCP Quick Reference
-| Tool | Use |
-|------|-----|
-| \`query-collection\` | List/filter documents |
-| \`create-collection\` | Create documents |
-| \`update-field-config\` | Hide unused fields |
-| \`get-tenant-context\` | Show active features & collections |
-
-## CLI
-- \`01 query <collection>\` \u2014 query data
-- \`01 schema show <collection>\` \u2014 inspect fields
-- \`01 schema list\` \u2014 list all collections
-
-## Initial Setup
-Run \`/01software-field-config\` in Claude Code to configure field visibility for your use case.
-`;
-}
-function getSkillFiles() {
-  return [
-    {
-      dirName: "01software-field-config",
-      content: `---
-name: 01software-field-config
-description: Configure field visibility for this tenant \u2014 hide unused collections and fields via MCP
-disable-model-invocation: true
----
-
-Steps:
-1. Use \`list-configurable-fields\` to see current visibility settings
-2. Identify fields/collections not needed for your use case
-3. Use \`update-field-config\` to hide them
-
-Common setups:
-- Blog only: hide \`ecommerce\`, \`customers\`, \`videos\` collections
-- Store: hide \`posts\`, \`documents\`, \`galleries\`, \`canvas\` collections
-- Minimal: hide all except the collections you actively use
-
-Ask me: "Show current field config" or "Hide ecommerce fields"
-`
-    },
-    {
-      dirName: "01software-query",
-      content: `---
-name: 01software-query
-description: Query 01.software collections via MCP or CLI with filter, sort, and pagination examples
----
-
-Query collections using the MCP \`query-collection\` tool or CLI.
-
-MCP examples:
-- List products: \`query-collection\` with collection="products", limit=10
-- Filter by status: add where={"status":{"equals":"published"}}
-- Sort by date: sort="-createdAt"
-- Paginate: page=2, limit=20
-
-CLI examples:
-- \`01 query products --limit 10\`
-- \`01 query orders --where '{"status":{"equals":"paid"}}'\`
-- \`01 schema show products\` \u2014 inspect available fields
-
-SDK (server):
-\`\`\`typescript
-const { docs } = await serverClient.collection('products').find({
-  where: { status: { equals: 'published' } },
-  sort: '-createdAt',
-  limit: 10,
-})
-\`\`\`
-`
-    },
-    {
-      dirName: "01software-order-flow",
-      content: `---
-name: 01software-order-flow
-description: Order lifecycle reference \u2014 create, pay, fulfill, and return flows for 01.software
----
-
-Complete order flow from creation to fulfillment.
-
-States: pending \u2192 paid \u2192 preparing \u2192 shipped \u2192 delivered \u2192 confirmed
-
-1. Create order: \`create-order\` with orderNumber, customerSnapshot, orderProducts, totalAmount
-2. Mark paid: \`update-order\` with status="paid" (after payment gateway confirms)
-3. Fulfill: \`create-fulfillment\` with items and carrier/trackingNumber
-4. Returns: \`create-return\` or \`return-with-refund\` (atomic)
-
-Free orders: omit paymentId, totalAmount=0 \u2192 auto-transitions to paid
-
-CLI: \`01 order create --help\` for full options
-`
-    },
-    {
-      dirName: "01software-schema",
-      content: `---
-name: 01software-schema
-description: Inspect 01.software collection schemas and available fields via MCP or CLI
----
-
-Inspect collection schemas to understand available fields.
-
-MCP: use \`get-collection-fields\` with collectionSlug
-
-CLI:
-- \`01 schema list\` \u2014 all available collections
-- \`01 schema show <collection>\` \u2014 field names, types, required status
-
-Common collections: products, orders, customers, posts, documents, images
-Use \`get-tenant-context\` to see which collections are active for this tenant.
-`
-    }
-  ];
-}
-async function fetchTenantContext(publishableKey, secretKey) {
-  try {
-    const apiUrl = process.env.SOFTWARE_API_URL || "https://api.01.software";
-    const res = await fetch(`${apiUrl}/api/tenants/context`, {
-      headers: {
-        "X-Publishable-Key": publishableKey,
-        Authorization: `Bearer ${secretKey}`
-      }
-    });
-    if (!res.ok) return null;
-    const data = await res.json();
-    return {
-      tenantName: data.tenant?.name || "",
-      features: data.features || [],
-      collections: data.collections || []
-    };
-  } catch {
-    return null;
-  }
-}
-
 // src/init.ts
 var SECRET_KEY_ENV_VAR = "SOFTWARE_SECRET_KEY";
 async function init(cwd, info, answers) {
@@ -680,71 +455,55 @@ async function init(cwd, info, answers) {
   const wantsReactQuery = needsReactQuery(env);
   const deps = ["@01.software/sdk"];
   if (wantsReactQuery) deps.push("@tanstack/react-query");
+  const addCmd = buildAddCmd(packageManager, hasPnpmWorkspace(cwd), deps);
+  let installFailed = false;
   console.log(pc2.dim(`  Installing ${deps.join(" and ")}...`));
   const wsPatched = packageManager === "pnpm" && patchPnpmWorkspace(cwd);
-  const pkgs = deps.join(" ");
-  const pnpmFlag = hasPnpmWorkspace(cwd) ? " -w" : "";
-  const addCmd = packageManager === "pnpm" ? `pnpm add${pnpmFlag} ${pkgs}` : packageManager === "yarn" ? `yarn add ${pkgs}` : packageManager === "bun" ? `bun add ${pkgs}` : `npm install ${pkgs}`;
   try {
     execSync(addCmd, { cwd, stdio: "pipe" });
+    console.log(pc2.green("  Installed"), deps.join(", "));
   } catch (error) {
+    installFailed = true;
     const err = error;
     const msg = String(err.stderr || "").trim() || String(err.stdout || "").trim() || String(error);
-    console.log(pc2.red("  Failed to install dependencies:"));
-    console.log(pc2.dim(`  ${msg}`));
-    throw error;
+    console.log(pc2.yellow("  Install failed \u2014 continuing with scaffolding"));
+    const firstLines = msg.split("\n").slice(0, 3).map((l) => `    ${l}`).join("\n");
+    if (firstLines) console.log(pc2.dim(firstLines));
+    console.log(pc2.dim(`    Run manually: ${addCmd}`));
   } finally {
     if (wsPatched) restorePnpmWorkspace(cwd);
   }
   const libDir = path2.join(baseDir, "lib", "software");
   fs2.mkdirSync(libDir, { recursive: true });
   if (wantsClient) {
-    const clientPath = path2.join(libDir, "client.ts");
-    if (fs2.existsSync(clientPath)) {
-      console.log(pc2.yellow("  Skipped"), relativePath(cwd, clientPath), pc2.dim("(already exists)"));
-    } else {
-      fs2.writeFileSync(clientPath, getClientTemplate(env, publishableKeyEnvVar));
-      console.log(pc2.green("  Created"), relativePath(cwd, clientPath));
-    }
+    writeFileIfAbsent(
+      cwd,
+      path2.join(libDir, "client.ts"),
+      getClientTemplate(env, publishableKeyEnvVar)
+    );
   }
   if (wantsReactQuery) {
-    const queryProviderPath = path2.join(libDir, "query-provider.tsx");
-    if (fs2.existsSync(queryProviderPath)) {
-      console.log(pc2.yellow("  Skipped"), relativePath(cwd, queryProviderPath), pc2.dim("(already exists)"));
-    } else {
-      fs2.writeFileSync(queryProviderPath, getQueryProviderTemplate(env));
-      console.log(pc2.green("  Created"), relativePath(cwd, queryProviderPath));
-    }
+    writeFileIfAbsent(
+      cwd,
+      path2.join(libDir, "query-provider.tsx"),
+      getQueryProviderTemplate(env)
+    );
   }
   if (wantsServer) {
-    const serverPath = path2.join(libDir, "server.ts");
-    if (fs2.existsSync(serverPath)) {
-      console.log(pc2.yellow("  Skipped"), relativePath(cwd, serverPath), pc2.dim("(already exists)"));
-    } else {
-      fs2.writeFileSync(serverPath, getServerTemplate(env, publishableKeyEnvVar, SECRET_KEY_ENV_VAR));
-      console.log(pc2.green("  Created"), relativePath(cwd, serverPath));
-    }
+    writeFileIfAbsent(
+      cwd,
+      path2.join(libDir, "server.ts"),
+      getServerTemplate(env, publishableKeyEnvVar, SECRET_KEY_ENV_VAR)
+    );
   }
   if (env !== "vanilla" && env !== "edge" && answers.authMethod !== "browser") {
-    const envPath = path2.join(cwd, ".env");
-    const envContent = getEnvContent(
+    writeEnv(
+      cwd,
       answers.publishableKey || "",
       answers.secretKey || "",
       publishableKeyEnvVar,
       wantsServer ? SECRET_KEY_ENV_VAR : null
     );
-    if (fs2.existsSync(envPath)) {
-      const existing = fs2.readFileSync(envPath, "utf-8");
-      if (existing.includes(publishableKeyEnvVar)) {
-        console.log(pc2.yellow("  Skipped"), ".env", pc2.dim("(keys already present)"));
-      } else {
-        fs2.appendFileSync(envPath, envContent);
-        console.log(pc2.green("  Updated"), ".env");
-      }
-    } else {
-      fs2.writeFileSync(envPath, envContent.trimStart());
-      console.log(pc2.green("  Created"), ".env");
-    }
   }
   let publishableKey = answers.publishableKey;
   let secretKey = answers.secretKey;
@@ -757,23 +516,14 @@ async function init(cwd, info, answers) {
       secretKey = creds.secretKey;
       tenantName = creds.tenantName;
       if (env !== "vanilla" && env !== "edge" && publishableKey) {
-        const envPath = path2.join(cwd, ".env");
-        const envContent = getEnvContent(
+        writeEnv(
+          cwd,
           publishableKey,
           secretKey,
           publishableKeyEnvVar,
-          wantsServer ? SECRET_KEY_ENV_VAR : null
+          wantsServer ? SECRET_KEY_ENV_VAR : null,
+          true
         );
-        if (fs2.existsSync(envPath)) {
-          const existing = fs2.readFileSync(envPath, "utf-8");
-          if (!existing.includes(publishableKeyEnvVar)) {
-            fs2.appendFileSync(envPath, envContent);
-            console.log(pc2.green("  Updated"), ".env", pc2.dim("(added API keys)"));
-          }
-        } else {
-          fs2.writeFileSync(envPath, envContent.trimStart());
-          console.log(pc2.green("  Created"), ".env");
-        }
       }
     } catch (err) {
       console.log(
@@ -792,63 +542,147 @@ async function init(cwd, info, answers) {
       await writeClaudeDocs(cwd, publishableKey, secretKey, tenantName);
     }
   }
+  return { installFailed, installCmd: addCmd };
 }
-function writeMcpConfig(tool, cwd, apiKey) {
-  let configPath;
-  let displayPath;
+function buildAddCmd(pm, hasPnpmWs, deps) {
+  const pkgs = deps.join(" ");
+  switch (pm) {
+    case "pnpm":
+      return hasPnpmWs ? `pnpm add -w ${pkgs}` : `pnpm add ${pkgs}`;
+    case "yarn":
+      return `yarn add ${pkgs}`;
+    case "bun":
+      return `bun add ${pkgs}`;
+    default:
+      return `npm install ${pkgs}`;
+  }
+}
+function writeFileIfAbsent(cwd, filePath, content) {
+  if (fs2.existsSync(filePath)) {
+    console.log(pc2.yellow("  Skipped"), relativePath(cwd, filePath), pc2.dim("(already exists)"));
+    return;
+  }
+  fs2.writeFileSync(filePath, content);
+  console.log(pc2.green("  Created"), relativePath(cwd, filePath));
+}
+function writeEnv(cwd, publishableKey, secretKey, publishableKeyEnvVar, secretKeyEnvVar, afterBrowserAuth = false) {
+  const envPath = path2.join(cwd, ".env");
+  const envContent = getEnvContent(publishableKey, secretKey, publishableKeyEnvVar, secretKeyEnvVar);
+  if (fs2.existsSync(envPath)) {
+    const existing = fs2.readFileSync(envPath, "utf-8");
+    if (existing.includes(publishableKeyEnvVar)) {
+      if (!afterBrowserAuth) {
+        console.log(pc2.yellow("  Skipped"), ".env", pc2.dim("(keys already present)"));
+      }
+      return;
+    }
+    fs2.appendFileSync(envPath, envContent);
+    console.log(
+      pc2.green("  Updated"),
+      ".env",
+      afterBrowserAuth ? pc2.dim("(added API keys)") : ""
+    );
+  } else {
+    fs2.writeFileSync(envPath, envContent.trimStart());
+    console.log(pc2.green("  Created"), ".env");
+  }
+}
+function resolveMcpLocation(tool, cwd) {
+  const home = os.homedir();
   switch (tool) {
     case "claude":
-      configPath = path2.join(cwd, ".mcp.json");
-      displayPath = ".mcp.json";
-      break;
+      return {
+        kind: "json",
+        absolutePath: path2.join(cwd, ".mcp.json"),
+        displayPath: ".mcp.json",
+        gitignoreEntry: ".mcp.json"
+      };
     case "cursor":
-      configPath = path2.join(cwd, ".cursor", "mcp.json");
-      displayPath = ".cursor/mcp.json";
-      fs2.mkdirSync(path2.dirname(configPath), { recursive: true });
-      break;
+      return {
+        kind: "json",
+        absolutePath: path2.join(cwd, ".cursor", "mcp.json"),
+        displayPath: ".cursor/mcp.json",
+        gitignoreEntry: ".cursor/mcp.json"
+      };
     case "vscode":
-      configPath = path2.join(cwd, ".vscode", "mcp.json");
-      displayPath = ".vscode/mcp.json";
-      fs2.mkdirSync(path2.dirname(configPath), { recursive: true });
-      break;
+      return {
+        kind: "json",
+        absolutePath: path2.join(cwd, ".vscode", "mcp.json"),
+        displayPath: ".vscode/mcp.json",
+        gitignoreEntry: ".vscode/mcp.json"
+      };
     case "windsurf": {
-      const home = process.env.HOME || process.env.USERPROFILE || "";
-      if (!home) {
-        console.log(pc2.yellow("  Skipped windsurf"), pc2.dim("(HOME not set)"));
-        return;
-      }
-      configPath = path2.join(home, ".codeium", "windsurf", "mcp_config.json");
-      displayPath = configPath;
-      fs2.mkdirSync(path2.dirname(configPath), { recursive: true });
-      break;
+      if (!home) return null;
+      const p = path2.join(home, ".codeium", "windsurf", "mcp_config.json");
+      return { kind: "json", absolutePath: p, displayPath: p, gitignoreEntry: null };
     }
-    default:
-      return;
+    case "codex": {
+      if (!home) return null;
+      const p = path2.join(home, ".codex", "config.toml");
+      return { kind: "toml", absolutePath: p, displayPath: p, gitignoreEntry: null };
+    }
+    case "gemini": {
+      if (!home) return null;
+      const p = path2.join(home, ".gemini", "settings.json");
+      return { kind: "json", absolutePath: p, displayPath: p, gitignoreEntry: null };
+    }
+  }
+}
+function writeMcpConfig(tool, cwd, apiKey) {
+  const loc = resolveMcpLocation(tool, cwd);
+  if (!loc) {
+    console.log(pc2.yellow(`  Skipped ${tool}`), pc2.dim("(HOME not set)"));
+    return;
+  }
+  fs2.mkdirSync(path2.dirname(loc.absolutePath), { recursive: true });
+  if (loc.kind === "json") {
+    writeJsonMcp(loc, apiKey);
+  } else {
+    writeTomlMcp(loc, apiKey);
   }
-  if (fs2.existsSync(configPath)) {
+}
+function writeJsonMcp(loc, apiKey) {
+  if (fs2.existsSync(loc.absolutePath)) {
     try {
-      const existing = JSON.parse(fs2.readFileSync(configPath, "utf-8"));
+      const existing = JSON.parse(fs2.readFileSync(loc.absolutePath, "utf-8"));
       if (existing.mcpServers?.["01software"]) {
-        console.log(pc2.yellow("  Skipped"), displayPath, pc2.dim("(01software already configured)"));
+        console.log(pc2.yellow("  Skipped"), loc.displayPath, pc2.dim("(01software already configured)"));
         return;
       }
       existing.mcpServers = existing.mcpServers || {};
       existing.mcpServers["01software"] = getMcpServerEntry(apiKey);
-      fs2.writeFileSync(configPath, JSON.stringify(existing, null, 2) + "\n");
-      console.log(pc2.green("  Updated"), displayPath);
+      fs2.writeFileSync(loc.absolutePath, JSON.stringify(existing, null, 2) + "\n");
+      console.log(pc2.green("  Updated"), loc.displayPath);
     } catch {
-      console.log(pc2.yellow("  Skipped"), displayPath, pc2.dim("(could not parse existing file)"));
+      console.log(pc2.yellow("  Skipped"), loc.displayPath, pc2.dim("(could not parse existing file)"));
     }
   } else {
-    fs2.writeFileSync(configPath, getMcpConfigTemplate(apiKey));
-    console.log(pc2.green("  Created"), displayPath);
+    fs2.writeFileSync(loc.absolutePath, getMcpConfigTemplate(apiKey));
+    console.log(pc2.green("  Created"), loc.displayPath);
+  }
+}
+function writeTomlMcp(loc, apiKey) {
+  const section = getCodexMcpTomlSection(apiKey);
+  if (fs2.existsSync(loc.absolutePath)) {
+    const existing = fs2.readFileSync(loc.absolutePath, "utf-8");
+    if (existing.includes(CODEX_MCP_SECTION_MARKER)) {
+      console.log(pc2.yellow("  Skipped"), loc.displayPath, pc2.dim("(01software already configured)"));
+      return;
+    }
+    const sep = existing.endsWith("\n") ? "" : "\n";
+    fs2.appendFileSync(loc.absolutePath, sep + section);
+    console.log(pc2.green("  Updated"), loc.displayPath);
+  } else {
+    fs2.writeFileSync(loc.absolutePath, section.trimStart());
+    console.log(pc2.green("  Created"), loc.displayPath);
   }
 }
 function addToGitignore(cwd, tools) {
   const entries = [];
-  if (tools.includes("claude")) entries.push(".mcp.json");
-  if (tools.includes("cursor")) entries.push(".cursor/mcp.json");
-  if (tools.includes("vscode")) entries.push(".vscode/mcp.json");
+  for (const tool of tools) {
+    const loc = resolveMcpLocation(tool, cwd);
+    if (loc?.gitignoreEntry) entries.push(loc.gitignoreEntry);
+  }
   if (entries.length === 0) return;
   const gitignorePath = path2.join(cwd, ".gitignore");
   const existing = fs2.existsSync(gitignorePath) ? fs2.readFileSync(gitignorePath, "utf-8") : "";
@@ -966,7 +800,7 @@ var OTHER_FRAMEWORK_GUIDE = `
        secretKey: process.env.SOFTWARE_SECRET_KEY!,
      })
 
-  4. Docs: https://01.software/docs/guide/quickstart
+  4. Docs: https://01.software/docs/developers/sdk/client
 `;
 async function main() {
   const cwd = process.cwd();
@@ -975,7 +809,7 @@ async function main() {
   console.log(pc3.dim("  Initialize 01.software SDK in your project"));
   console.log();
   const info = detectProject(cwd);
-  if (!info.hasPackageJson) {
+  if (!info.hasPackageJson || info.parseError) {
     if (info.parseError) {
       console.log(pc3.red("  Could not parse package.json (invalid JSON)."));
       console.log(pc3.dim("  Fix the syntax error and try again."));
@@ -1007,7 +841,7 @@ async function main() {
     const resolvedPm = info.packageManager ?? answers.packageManager ?? "npm";
     const resolvedInfo = { ...info, packageManager: resolvedPm };
     console.log();
-    await init(cwd, resolvedInfo, answers);
+    const result = await init(cwd, resolvedInfo, answers);
     const env = answers.env;
     const run = resolvedPm === "npm" ? "npm run" : resolvedPm;
     console.log();
@@ -1015,6 +849,11 @@ async function main() {
     console.log();
     console.log("  Next steps:");
     console.log();
+    if (result.installFailed) {
+      console.log(pc3.yellow("  Install the SDK manually:"));
+      console.log(pc3.cyan(`    ${result.installCmd}`));
+      console.log();
+    }
     if (env === "nextjs") {
       console.log(pc3.dim("  Add QueryProvider to your root layout:"));
       console.log();
@@ -1053,7 +892,7 @@ async function main() {
       console.log();
     }
     if (answers.aiTools.length > 0 && (!answers.publishableKey || !answers.secretKey)) {
-      console.log(pc3.dim("  Update .mcp.json x-api-key with your sk01_... token"));
+      console.log(pc3.dim("  Update MCP config x-api-key with your sk01_... token"));
       console.log();
     }
     if (env !== "vanilla") {