@piut/cli 3.8.0 → 3.9.0

package/README.md

@@ -169,7 +169,7 @@ Three ways to connect your brain to your AI tools:
 
 For scripting: `piut setup --key pb_YOUR_KEY --yes`
 
-**Supported tools:** Claude Code, Claude Desktop, Cursor, Windsurf, GitHub Copilot, Amazon Q, Zed, ChatGPT, OpenClaw, Msty, OpenAI Agents SDK, Claude Agent SDK, and any MCP client.
+**Supported tools:** Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Amazon Q, Zed, ChatGPT, OpenClaw, Msty, OpenAI Agents SDK, Claude Agent SDK, and any MCP client.
 
 ### skill.md Reference
 
@@ -180,7 +180,7 @@ Add a reference to [skill.md](skill.md) in your tool's rules file so your AI kno
 | Claude Code | CLAUDE.md or ~/.claude/CLAUDE.md |
 | Cursor | .cursor/rules/piut.mdc |
 | Windsurf | .windsurf/rules/piut.md |
-| GitHub Copilot | .github/copilot-instructions.md |
+| VS Code | .github/copilot-instructions.md |
 | Claude Desktop | Project Knowledge (upload file) |
 | ChatGPT | Settings > Custom Instructions |
 | Zed | .zed/rules.md |
@@ -224,7 +224,7 @@ piut sync --pull       # Pull cloud changes
 | `AGENTS.md` | Multi-agent | Repo root |
 | `.cursorrules` | Cursor | Repo root |
 | `.windsurfrules` | Windsurf | Repo root |
-| `copilot-instructions.md` | GitHub Copilot | .github/ |
+| `copilot-instructions.md` | VS Code | .github/ |
 | `MEMORY.md` | Claude Code | ~/.claude/ |
 | `SOUL.md` | OpenClaw | ~/.openclaw/workspace/ |
 | `rules/*.md` | Various | .cursor/rules/, .claude/rules/ |

package/dist/cli.js

@@ -28,7 +28,7 @@ __export(tree_prompt_exports, {
   loadChildren: () => loadChildren,
   shouldShowInTree: () => shouldShowInTree
 });
-import fs13 from "fs";
+import fs14 from "fs";
 import path14 from "path";
 import os8 from "os";
 import {
@@ -55,7 +55,7 @@ function shouldShowFile(name) {
 }
 function loadChildren(parentPath, parentDepth, includeFiles = false) {
   try {
-    const entries = fs13.readdirSync(parentPath, { withFileTypes: true });
+    const entries = fs14.readdirSync(parentPath, { withFileTypes: true });
     const dirs = [];
     const files = [];
     for (const entry of entries) {
@@ -384,29 +384,33 @@ async function* buildBrainStreaming(key, input2) {
   const reader = res.body.getReader();
   const decoder = new TextDecoder();
   let buffer = "";
-  while (true) {
-    const { done, value } = await reader.read();
-    if (done) break;
-    buffer += decoder.decode(value, { stream: true });
-    const parts = buffer.split("\n\n");
-    buffer = parts.pop() || "";
-    for (const part of parts) {
-      let eventName = "";
-      let eventData = "";
-      for (const line of part.split("\n")) {
-        if (line.startsWith("event: ")) {
-          eventName = line.slice(7).trim();
-        } else if (line.startsWith("data: ")) {
-          eventData = line.slice(6);
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const parts = buffer.split("\n\n");
+      buffer = parts.pop() || "";
+      for (const part of parts) {
+        let eventName = "";
+        let eventData = "";
+        for (const line of part.split("\n")) {
+          if (line.startsWith("event: ")) {
+            eventName = line.slice(7).trim();
+          } else if (line.startsWith("data: ")) {
+            eventData = line.slice(6);
+          }
         }
-      }
-      if (eventName && eventData) {
-        try {
-          yield { event: eventName, data: JSON.parse(eventData) };
-        } catch {
+        if (eventName && eventData) {
+          try {
+            yield { event: eventName, data: JSON.parse(eventData) };
+          } catch {
+          }
         }
       }
     }
+  } catch {
+    yield { event: "error", data: { message: "Connection lost. The build may still complete \u2014 run `piut status` to check." } };
   }
 }
 async function verifyMcpEndpoint(serverUrl, key) {
@@ -700,21 +704,20 @@ var TOOLS = [
     })
   },
   {
-    id: "copilot",
-    name: "GitHub Copilot",
+    id: "vscode",
+    name: "VS Code",
     configKey: "servers",
-    globalConfigKey: "mcp.servers",
     configPaths: {
-      darwin: ["~/Library/Application Support/Code/User/settings.json"],
-      win32: [path2.join(appData(), "Code", "User", "settings.json")],
-      linux: ["~/.config/Code/User/settings.json"],
+      darwin: ["~/Library/Application Support/Code/User/mcp.json"],
+      win32: [path2.join(appData(), "Code", "User", "mcp.json")],
+      linux: ["~/.config/Code/User/mcp.json"],
       project: [".vscode/mcp.json"]
     },
     skillFilePath: ".github/copilot-instructions.md",
     generateConfig: (slug, key) => ({
       type: "http",
       url: MCP_URL(slug),
-      headers: { ...AUTH_HEADER(key), ...machineHeaders("GitHub Copilot") }
+      headers: { ...AUTH_HEADER(key), ...machineHeaders("VS Code") }
     })
   },
   {
@@ -1058,6 +1061,16 @@ function writePiutConfig(projectPath, config) {
     "utf-8"
   );
 }
+function readPiutConfig(projectPath) {
+  try {
+    const raw = fs3.readFileSync(path6.join(piutDir(projectPath), CONFIG_FILE), "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed.slug && parsed.apiKey && parsed.serverUrl) return parsed;
+    return null;
+  } catch {
+    return null;
+  }
+}
 async function writePiutSkill(projectPath, slug, apiKey) {
   const dir = piutDir(projectPath);
   fs3.mkdirSync(dir, { recursive: true });
@@ -2013,7 +2026,10 @@ import os7 from "os";
 init_esm_shims();
 import { select, input, password as password2 } from "@inquirer/prompts";
 import { exec } from "child_process";
+import http from "http";
+import crypto3 from "crypto";
 import chalk4 from "chalk";
+var API_BASE4 = process.env.PIUT_API_BASE || "https://piut.com";
 function openBrowser(url) {
   const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
   exec(`${cmd} "${url}"`);
@@ -2052,12 +2068,101 @@ async function pasteKeyFlow() {
   return { apiKey, validation };
 }
 async function browserFlow() {
-  const url = "https://piut.com/dashboard/keys";
-  console.log(dim(`  Opening ${brand(url)}...`));
-  openBrowser(url);
-  console.log(dim("  Copy your API key from the dashboard, then paste it here."));
-  console.log();
-  return pasteKeyFlow();
+  const state = crypto3.randomBytes(16).toString("hex");
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const server = http.createServer((req, res) => {
+      const url = new URL(req.url, `http://localhost`);
+      if (url.pathname !== "/callback") {
+        res.writeHead(404);
+        res.end();
+        return;
+      }
+      const key = url.searchParams.get("key");
+      const returnedState = url.searchParams.get("state");
+      if (returnedState !== state) {
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end(errorPage("State mismatch. Please try again from the CLI."));
+        cleanup();
+        if (!settled) {
+          settled = true;
+          reject(new CliError("Browser auth state mismatch"));
+        }
+        return;
+      }
+      if (!key || !key.startsWith("pb_")) {
+        res.writeHead(400, { "Content-Type": "text/html" });
+        res.end(errorPage("No valid API key received."));
+        cleanup();
+        if (!settled) {
+          settled = true;
+          reject(new CliError("No API key received from browser"));
+        }
+        return;
+      }
+      res.writeHead(200, { "Content-Type": "text/html" });
+      res.end(successPage());
+      cleanup();
+      validateKey(key).then((validation) => {
+        if (!settled) {
+          settled = true;
+          resolve({ apiKey: key, validation });
+        }
+      }).catch((err) => {
+        if (!settled) {
+          settled = true;
+          reject(err);
+        }
+      });
+    });
+    const timer = setTimeout(() => {
+      cleanup();
+      if (!settled) {
+        settled = true;
+        reject(new CliError("Browser login timed out after 2 minutes. Please try again."));
+      }
+    }, 12e4);
+    function cleanup() {
+      clearTimeout(timer);
+      server.close();
+    }
+    server.listen(0, "127.0.0.1", () => {
+      const { port } = server.address();
+      const authUrl = `${API_BASE4}/cli/auth?port=${port}&state=${state}`;
+      console.log(dim(`  Opening ${brand("piut.com")} in your browser...`));
+      openBrowser(authUrl);
+      console.log(dim("  Waiting for browser authorization..."));
+    });
+    server.on("error", (err) => {
+      cleanup();
+      if (!settled) {
+        settled = true;
+        reject(new CliError(`Failed to start callback server: ${err.message}`));
+      }
+    });
+  });
+}
+function successPage() {
+  return `<!DOCTYPE html>
+<html><head><title>p\u0131ut CLI</title></head>
+<body style="background:#0a0a0a;color:white;font-family:system-ui;display:flex;align-items:center;justify-content:center;height:100vh;margin:0">
+<div style="text-align:center">
+<div style="font-size:48px;color:#4ade80;margin-bottom:16px">&#10003;</div>
+<h2 style="margin:0 0 8px">CLI Authorized</h2>
+<p style="color:#a3a3a3;margin:0">You can close this tab and return to your terminal.</p>
+</div>
+</body></html>`;
+}
+function errorPage(message) {
+  return `<!DOCTYPE html>
+<html><head><title>p\u0131ut CLI</title></head>
+<body style="background:#0a0a0a;color:white;font-family:system-ui;display:flex;align-items:center;justify-content:center;height:100vh;margin:0">
+<div style="text-align:center">
+<div style="font-size:48px;color:#f87171;margin-bottom:16px">&#10007;</div>
+<h2 style="margin:0 0 8px">Authorization Failed</h2>
+<p style="color:#a3a3a3;margin:0">${message}</p>
+</div>
+</body></html>`;
 }
 async function promptLogin() {
   const method = await select({
@@ -2071,7 +2176,7 @@ async function promptLogin() {
       {
         name: "Log in with browser",
         value: "browser",
-        description: "Open piut.com to get your API key"
+        description: "Sign in via piut.com (opens browser)"
       },
       {
         name: "Paste API key",
@@ -2365,7 +2470,7 @@ var RULE_FILES = [
     detect: (p) => p.hasWindsurfRules || fs9.existsSync(path11.join(p.path, ".windsurf"))
   },
   {
-    tool: "GitHub Copilot",
+    tool: "VS Code",
     filePath: ".github/copilot-instructions.md",
     strategy: "append",
     detect: (p) => p.hasCopilotInstructions || fs9.existsSync(path11.join(p.path, ".github"))
@@ -2546,7 +2651,7 @@ async function connectCommand(options) {
   }
   console.log();
   let connected = 0;
-  const copilotTool = TOOLS.find((t) => t.id === "copilot");
+  const vscodeTool = TOOLS.find((t) => t.id === "vscode");
   for (const projectPath of selectedPaths) {
     const projectActions = byProject.get(projectPath) || [];
     const projectName = path11.basename(projectPath);
@@ -2554,13 +2659,13 @@ async function connectCommand(options) {
     await writePiutSkill(projectPath, slug, apiKey);
     ensureGitignored(projectPath);
     console.log(success(`  \u2713 ${projectName}/.piut/`) + dim(" \u2014 credentials + skill"));
-    if (copilotTool) {
-      const hasCopilot = fs9.existsSync(path11.join(projectPath, ".github", "copilot-instructions.md")) || fs9.existsSync(path11.join(projectPath, ".github"));
-      if (hasCopilot) {
+    if (vscodeTool) {
+      const hasVscode = fs9.existsSync(path11.join(projectPath, ".github", "copilot-instructions.md")) || fs9.existsSync(path11.join(projectPath, ".github"));
+      if (hasVscode) {
         const vscodeMcpPath = path11.join(projectPath, ".vscode", "mcp.json");
-        const serverConfig = copilotTool.generateConfig(slug, apiKey);
-        mergeConfig(vscodeMcpPath, copilotTool.configKey, serverConfig);
-        console.log(success(`  \u2713 ${projectName}/.vscode/mcp.json`) + dim(" \u2014 Copilot MCP"));
+        const serverConfig = vscodeTool.generateConfig(slug, apiKey);
+        mergeConfig(vscodeMcpPath, vscodeTool.configKey, serverConfig);
+        console.log(success(`  \u2713 ${projectName}/.vscode/mcp.json`) + dim(" \u2014 VS Code MCP"));
       }
     }
     for (const action of projectActions) {
@@ -3228,10 +3333,45 @@ async function vaultDeleteCommand(filename, options) {
 // src/commands/interactive.ts
 init_esm_shims();
 import { select as select2, confirm as confirm8, checkbox as checkbox5, Separator } from "@inquirer/prompts";
-import fs14 from "fs";
+import fs15 from "fs";
 import path15 from "path";
 import { exec as exec2 } from "child_process";
 import chalk13 from "chalk";
+
+// src/lib/sync.ts
+init_esm_shims();
+import fs13 from "fs";
+function syncStaleConfigs(slug, apiKey, serverUrl) {
+  const updated = [];
+  for (const tool of TOOLS) {
+    if (tool.skillOnly || !tool.generateConfig || !tool.configKey) continue;
+    const paths = resolveConfigPaths(tool);
+    for (const { filePath, configKey } of paths) {
+      if (!fs13.existsSync(filePath)) continue;
+      const piutConfig = getPiutConfig(filePath, configKey);
+      if (!piutConfig) continue;
+      const existingKey = extractKeyFromConfig(piutConfig);
+      const existingSlug = extractSlugFromConfig(piutConfig);
+      const keyStale = !!existingKey && existingKey !== apiKey;
+      const slugStale = !!existingSlug && existingSlug !== slug;
+      if (keyStale || slugStale) {
+        const newConfig = tool.generateConfig(slug, apiKey);
+        mergeConfig(filePath, configKey, newConfig);
+        updated.push(tool.name);
+      }
+      break;
+    }
+  }
+  const cwd = process.cwd();
+  const existing = readPiutConfig(cwd);
+  if (existing && (existing.apiKey !== apiKey || existing.slug !== slug)) {
+    writePiutConfig(cwd, { slug, apiKey, serverUrl });
+    updated.push(".piut/config.json");
+  }
+  return updated;
+}
+
+// src/commands/interactive.ts
 var DOCUMENT_EXTENSIONS2 = /* @__PURE__ */ new Set([
   "pdf",
   "docx",
@@ -3278,6 +3418,14 @@ async function interactiveMenu() {
   const auth = await authenticate();
   apiKey = auth.apiKey;
   currentValidation = auth.validation;
+  const synced = syncStaleConfigs(
+    currentValidation.slug,
+    apiKey,
+    currentValidation.serverUrl
+  );
+  if (synced.length > 0) {
+    console.log(dim(`  Updated ${synced.length} stale config(s): ${synced.join(", ")}`));
+  }
   console.log();
   if (currentValidation.status === "no_brain") {
     console.log(warning("  You haven\u2019t built a brain yet."));
@@ -3472,8 +3620,8 @@ async function handleConnectTools(apiKey, validation) {
   for (const tool of TOOLS) {
     const paths = resolveConfigPaths(tool);
     for (const { filePath, configKey } of paths) {
-      const exists = fs14.existsSync(filePath);
-      const parentExists = fs14.existsSync(path15.dirname(filePath));
+      const exists = fs15.existsSync(filePath);
+      const parentExists = fs15.existsSync(path15.dirname(filePath));
       if (exists || parentExists) {
         const connected = exists && !!configKey && isPiutConfigured(filePath, configKey);
         detected.push({ tool, configPath: filePath, resolvedConfigKey: configKey, connected });
@@ -3601,7 +3749,7 @@ async function handleManageProjects(apiKey, validation) {
     await writePiutSkill(project.path, slug, apiKey);
     ensureGitignored(project.path);
     if (copilotTool) {
-      const hasCopilot = fs14.existsSync(path15.join(project.path, ".github", "copilot-instructions.md")) || fs14.existsSync(path15.join(project.path, ".github"));
+      const hasCopilot = fs15.existsSync(path15.join(project.path, ".github", "copilot-instructions.md")) || fs15.existsSync(path15.join(project.path, ".github"));
       if (hasCopilot) {
         const vscodeMcpPath = path15.join(project.path, ".vscode", "mcp.json");
         const serverConfig = copilotTool.generateConfig(slug, apiKey);
@@ -3611,14 +3759,14 @@ async function handleManageProjects(apiKey, validation) {
     for (const rule of RULE_FILES) {
       if (!rule.detect(project)) continue;
       const absPath = path15.join(project.path, rule.filePath);
-      if (fs14.existsSync(absPath) && hasPiutReference2(absPath)) continue;
-      if (rule.strategy === "create" || !fs14.existsSync(absPath)) {
+      if (fs15.existsSync(absPath) && hasPiutReference2(absPath)) continue;
+      if (rule.strategy === "create" || !fs15.existsSync(absPath)) {
         const isAppendType = rule.strategy === "append";
         const content = isAppendType ? PROJECT_SKILL_SNIPPET + "\n" : DEDICATED_FILE_CONTENT;
-        fs14.mkdirSync(path15.dirname(absPath), { recursive: true });
-        fs14.writeFileSync(absPath, content, "utf-8");
+        fs15.mkdirSync(path15.dirname(absPath), { recursive: true });
+        fs15.writeFileSync(absPath, content, "utf-8");
       } else {
-        fs14.appendFileSync(absPath, APPEND_SECTION);
+        fs15.appendFileSync(absPath, APPEND_SECTION);
       }
     }
     toolLine(projectName, success("connected"), "\u2714");
@@ -3637,21 +3785,21 @@ async function handleManageProjects(apiKey, validation) {
     const projectName = path15.basename(project.path);
     for (const dedicatedFile of DEDICATED_FILES) {
       const absPath = path15.join(project.path, dedicatedFile);
-      if (fs14.existsSync(absPath) && hasPiutReference2(absPath)) {
+      if (fs15.existsSync(absPath) && hasPiutReference2(absPath)) {
         try {
-          fs14.unlinkSync(absPath);
+          fs15.unlinkSync(absPath);
         } catch {
         }
       }
     }
     for (const appendFile of APPEND_FILES) {
       const absPath = path15.join(project.path, appendFile);
-      if (fs14.existsSync(absPath) && hasPiutReference2(absPath)) {
+      if (fs15.existsSync(absPath) && hasPiutReference2(absPath)) {
         removePiutSection(absPath);
       }
     }
     const vscodeMcpPath = path15.join(project.path, ".vscode", "mcp.json");
-    if (fs14.existsSync(vscodeMcpPath) && isPiutConfigured(vscodeMcpPath, "servers")) {
+    if (fs15.existsSync(vscodeMcpPath) && isPiutConfigured(vscodeMcpPath, "servers")) {
       removeFromConfig(vscodeMcpPath, "servers");
     }
     removePiutDir(project.path);
@@ -3749,10 +3897,10 @@ async function handleVaultUpload(apiKey) {
     let content;
     let encoding;
     if (isDocument) {
-      content = fs14.readFileSync(filePath).toString("base64");
+      content = fs15.readFileSync(filePath).toString("base64");
       encoding = "base64";
     } else {
-      content = fs14.readFileSync(filePath, "utf-8");
+      content = fs15.readFileSync(filePath, "utf-8");
     }
     const spinner = new Spinner();
     spinner.start(`Uploading ${filename}...`);
@@ -3828,7 +3976,7 @@ async function handleViewBrain(apiKey) {
 }
 
 // src/cli.ts
-var VERSION = "3.8.0";
+var VERSION = "3.9.0";
 function withExit(fn) {
   return async (...args2) => {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piut/cli",
-  "version": "3.8.0",
+  "version": "3.9.0",
   "description": "Build your AI brain instantly. Deploy it as an MCP server. Connect it to every project.",
   "type": "module",
   "bin": {