rentline-sandbox 0.1.2 → 0.1.3

package/README.md

@@ -20,6 +20,32 @@ Requires Node.js ≥ 18.
 
 ---
 
+## Setup
+
+Run once after install. Saves your credentials and automatically configures your AI client:
+
+```bash
+sandbox setup
+```
+
+The wizard will:
+1. Ask for your API key (get one at **sandbox.rentline.xyz/cli-auth**)
+2. Verify connectivity to the API
+3. Save credentials to `~/.rentline-sandbox/credentials.json`
+4. Detect your AI client (Claude Code, Cursor, Windsurf, OpenCode) and patch its MCP config
+5. Install `SKILL.md` so your agent understands the game
+
+**Non-interactive:**
+```bash
+sandbox setup --key sb_xxx --client opencode --yes
+```
+
+Supported clients: `claude-code`, `claude-desktop`, `cursor`, `windsurf`, `opencode`, `zed`, `cline`
+
+After setup, **restart your AI client** to load the MCP server.
+
+---
+
 ## Authentication
 
 ### Browser login (recommended)

package/dist/index.js

@@ -9,7 +9,7 @@ var _require = createRequire(import.meta.url);
 var { version } = _require("../package.json");
 var args = process.argv.slice(2);
 if (args[0] === "setup" || args[0] === "--setup") {
-  const { runSetup, parseSetupArgs } = await import("./setup-JPLRGUPW.js");
+  const { runSetup, parseSetupArgs } = await import("./setup-IQQBGGOI.js");
   const opts = parseSetupArgs(args.filter((a) => a !== "setup" && a !== "--setup"));
   await runSetup(opts);
   process.exit(0);
@@ -31,7 +31,7 @@ if (args.length === 0 || args[0] === "server" || args[0] === "--server") {
   registerMortgage(program);
   registerAdmin(program);
   program.command("mcp-setup", { hidden: true }).allowUnknownOption().action(async () => {
-    const { runSetup, parseSetupArgs } = await import("./setup-JPLRGUPW.js");
+    const { runSetup, parseSetupArgs } = await import("./setup-IQQBGGOI.js");
     const opts = parseSetupArgs(process.argv.slice(3));
     await runSetup(opts);
   });

package/dist/{setup-JPLRGUPW.js → setup-IQQBGGOI.js}

@@ -51,7 +51,7 @@ async function runSetup(opts) {
     }
   }
   if (!apiKey) {
-    console.error("API key is required. Get one from your sandbox-api admin.");
+    console.error("API key is required. Get one at: https://sandbox.rentline.xyz/cli-auth");
     process.exit(1);
   }
   const existing = loadConfig();
@@ -121,7 +121,7 @@ async function installForClient(clientName, scope, apiKey, apiUrl, displayName)
   switch (clientName) {
     case "claude-code": {
       const { execSync } = await import("child_process");
-      const envFlags = Object.entries(entry.env ?? {}).map(([k, v]) => `-e ${k}=${v}`).join(" ");
+      const envFlags = Object.entries(entry.env ?? {}).map(([k, v]) => `-e ${k}="${v}"`).join(" ");
       const cmd = `claude mcp add rentline-sandbox --scope ${scope} ${envFlags} -- npx -y rentline-sandbox`;
       try {
         execSync(cmd, { stdio: "pipe" });
@@ -146,7 +146,14 @@ async function installForClient(clientName, scope, apiKey, apiUrl, displayName)
       break;
     }
     case "claude-desktop": {
-      const file = platform() === "win32" ? join(process.env.APPDATA ?? homedir(), "Claude", "claude_desktop_config.json") : join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+      let file;
+      if (platform() === "win32") {
+        file = join(process.env.APPDATA ?? homedir(), "Claude", "claude_desktop_config.json");
+      } else if (platform() === "darwin") {
+        file = join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+      } else {
+        file = join(homedir(), ".config", "Claude", "claude_desktop_config.json");
+      }
       patchMcpJson(file, "rentline-sandbox", entry, "mcpServers");
       console.log(`Patched ${file}`);
       break;
@@ -158,14 +165,23 @@ async function installForClient(clientName, scope, apiKey, apiUrl, displayName)
       break;
     }
     case "windsurf": {
-      const file = join(process.cwd(), ".windsurf", "mcp.json");
+      const file = platform() === "win32" ? join(process.env.APPDATA ?? homedir(), ".codeium", "windsurf", "mcp_config.json") : join(homedir(), ".codeium", "windsurf", "mcp_config.json");
       patchMcpJson(file, "rentline-sandbox", entry, "mcpServers");
       console.log(`Patched ${file}`);
       break;
     }
     case "opencode": {
       const file = scope === "project" ? join(process.cwd(), "opencode.json") : join(homedir(), ".config", "opencode", "config.json");
-      patchMcpJson(file, "rentline-sandbox", entry, "mcp");
+      const opencodeEntry = {
+        type: "local",
+        command: ["npx", "-y", "rentline-sandbox"],
+        enabled: true,
+        environment: {
+          SANDBOX_API_KEY: apiKey,
+          SANDBOX_API_URL: apiUrl
+        }
+      };
+      patchMcpJson(file, "rentline-sandbox", opencodeEntry, "mcp");
       console.log(`Patched ${file}`);
       const skillSrc = join(__dirname, "../SKILL.md");
       if (existsSync(skillSrc)) {
@@ -188,9 +204,10 @@ async function installForClient(clientName, scope, apiKey, apiUrl, displayName)
     case "other":
     default: {
       console.log(`
-Add the following to your MCP client config:
+Add the following to your MCP client config (exact key name may vary by client):
 `);
       console.log(JSON.stringify({ "rentline-sandbox": entry }, null, 2));
+      console.log("\nFor OpenCode specifically, use: sandbox setup --client opencode");
       break;
     }
   }
@@ -204,6 +221,9 @@ function patchMcpJson(filePath, serverName, entry, key) {
     } catch {
     }
   }
+  if (key === "mcp" && !config["$schema"]) {
+    config["$schema"] = "https://opencode.ai/config.json";
+  }
   const servers = config[key] ?? {};
   servers[serverName] = entry;
   config[key] = servers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rentline-sandbox",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "CLI and MCP server for the Rentline Sandbox real estate investment simulation game",
   "type": "module",
   "bin": {