changebook 0.2.0 → 0.3.0

package/README.md

@@ -15,9 +15,12 @@ npx changebook init   # login (browser) + register in Claude Code/Codex + sync
 
 `init` does four things: opens the browser so you sign in on changebook.app
 (one Authorize click — no token copy-pasting), registers the MCP server in
-Claude Code (user scope) and Codex (`~/.codex/config.toml`), installs the
+**every coding agent it finds on the machine** — Claude Code, Codex, Cursor,
+Windsurf, Claude Desktop and VS Code (Copilot agent mode) — installs the
 post-commit hook so the atlas updates itself, and writes the product map
-into the project's `CLAUDE.md`/`AGENTS.md`.
+into the project's `CLAUDE.md`/`AGENTS.md`. It only touches agents that are
+actually installed, and merges into existing MCP configs without clobbering
+your other servers.
 
 ## CLI commands
 

package/dist/index.js

@@ -33,7 +33,7 @@ Usage:
   changebook hook install|uninstall|status [dir]
                           Git post-commit hook: analyze every new commit automatically
   changebook sync [dir]     Refresh the product map inside CLAUDE.md/AGENTS.md
-  changebook init [dir]     login + register MCP (Claude Code, Codex) + hook + sync
+  changebook init [dir]     login + register MCP in every agent found + hook + sync
   changebook open           Open the web atlas in the browser
   changebook serve          Run the MCP server on stdio (default with no arguments)
 
@@ -143,9 +143,9 @@ async function main() {
                 await login();
                 db = new Supabase(); // pick up the freshly stored credentials
             }
-            for (const line of await registerAgents())
-                console.error(line);
             const dir = arg ?? process.cwd();
+            for (const line of await registerAgents(dir))
+                console.error(line);
             // The living-atlas part: analyze every new commit automatically. Not a
             // git repo (or a foreign hook already there) → explain and move on.
             try {

package/dist/init.js

@@ -1,8 +1,15 @@
 /**
  * `changebook init [dir]` — one-command setup for coding agents:
  *   1. Sign in if needed (browser flow).
- *   2. Register the MCP server in Claude Code (user scope) and Codex.
+ *   2. Register the MCP server in every agent found on the machine:
+ *      Claude Code (CLI), Codex, Cursor, Windsurf, Claude Desktop, VS Code.
  *   3. Sync the product map into the project's CLAUDE.md / AGENTS.md.
+ *
+ * Every agent runs the SAME stdio server (`changebook serve`); only the config
+ * file format and location differ. We only write config for agents that are
+ * already present (their dir/config exists), so init never litters the machine
+ * with settings for apps the user doesn't have. Existing configs are merged,
+ * never clobbered — a foreign JSON we can't parse is left untouched with a hint.
  */
 import * as fs from "node:fs";
 import * as os from "node:os";
@@ -14,63 +21,94 @@ function serverCommand() {
     const entry = path.join(path.dirname(fileURLToPath(import.meta.url)), "index.js");
     return { command: process.execPath, args: [entry, "serve"] };
 }
-export async function registerAgents() {
-    const done = [];
-    const { command, args } = serverCommand();
+async function registerClaudeCode(command, args) {
     // On Windows `claude` is a .cmd shim: execFile can't launch it without a
     // shell (Node throws EINVAL since CVE-2024-27980). Run through the shell there
     // and quote the path arguments so spaces (e.g. "Program Files") survive; the
     // rest are constant literals, so there's no injection surface.
     const isWin = process.platform === "win32";
     const quote = (s) => (isWin ? `"${s}"` : s);
-    // Claude Code: user scope, so every project sees the atlas tools.
     try {
-        await execFileAsync("claude", [
-            "mcp",
-            "add",
-            "--scope",
-            "user",
-            "changebook",
-            "--",
-            quote(command),
-            ...args.map(quote),
-        ], isWin ? { shell: true } : {});
-        done.push("Claude Code: MCP server registered (user scope).");
+        await execFileAsync("claude", ["mcp", "add", "--scope", "user", "changebook", "--", quote(command), ...args.map(quote)], isWin ? { shell: true } : {});
+        return "Claude Code: MCP server registered (user scope).";
     }
     catch (error) {
         const msg = error instanceof Error ? error.message : String(error);
-        if (/already exists/i.test(msg)) {
-            done.push("Claude Code: already configured.");
-        }
-        else if (/ENOENT|not recognized|command not found/i.test(msg)) {
-            done.push("Claude Code: `claude` CLI not found — install it and run `changebook init` again.");
-        }
-        else {
-            done.push(`Claude Code: could not register (${msg.split("\n")[0]}).`);
-        }
+        if (/already exists/i.test(msg))
+            return "Claude Code: already configured.";
+        if (/ENOENT|not recognized|command not found/i.test(msg))
+            return "Claude Code: `claude` CLI not found — skipped.";
+        return `Claude Code: could not register (${msg.split("\n")[0]}).`;
     }
-    // Codex reads ~/.codex/config.toml; append our server if it's not there.
-    const codexDir = path.join(os.homedir(), ".codex");
-    const codexConfig = path.join(codexDir, "config.toml");
-    if (fs.existsSync(codexDir)) {
-        const current = fs.existsSync(codexConfig)
-            ? fs.readFileSync(codexConfig, "utf8")
-            : "";
-        if (current.includes("[mcp_servers.changebook]")) {
-            done.push("Codex: already configured.");
-        }
-        else {
-            const argsToml = args.map((a) => JSON.stringify(a)).join(", ");
-            const block = `\n[mcp_servers.changebook]\n` +
-                `command = ${JSON.stringify(command)}\n` +
-                `args = [${argsToml}]\n`;
-            fs.appendFileSync(codexConfig, block);
-            done.push("Codex: MCP server added to ~/.codex/config.toml.");
+}
+function registerCodex(command, args) {
+    const codexConfig = path.join(os.homedir(), ".codex", "config.toml");
+    if (!fs.existsSync(path.dirname(codexConfig)))
+        return "Codex: not found — skipped.";
+    const current = fs.existsSync(codexConfig) ? fs.readFileSync(codexConfig, "utf8") : "";
+    if (current.includes("[mcp_servers.changebook]"))
+        return "Codex: already configured.";
+    const argsToml = args.map((a) => JSON.stringify(a)).join(", ");
+    const block = `\n[mcp_servers.changebook]\n` +
+        `command = ${JSON.stringify(command)}\n` +
+        `args = [${argsToml}]\n`;
+    fs.appendFileSync(codexConfig, block);
+    return "Codex: added to ~/.codex/config.toml.";
+}
+/**
+ * Merge our server into a JSON MCP config, preserving everything else.
+ * `topKey` is "mcpServers" for Cursor/Windsurf/Claude Desktop, "servers" for
+ * VS Code. Only writes if the app is present (parent dir exists). An existing
+ * file we can't parse is never overwritten.
+ */
+function registerJsonAgent(label, configPath, topKey, entry, requireParentDir = true) {
+    const parent = path.dirname(configPath);
+    if (requireParentDir && !fs.existsSync(parent))
+        return `${label}: not found — skipped.`;
+    let config = {};
+    if (fs.existsSync(configPath)) {
+        const raw = fs.readFileSync(configPath, "utf8").trim();
+        if (raw) {
+            try {
+                config = JSON.parse(raw);
+            }
+            catch {
+                return `${label}: config exists but isn't valid JSON — add "changebook" to ${topKey} by hand.`;
+            }
         }
     }
-    else {
-        done.push("Codex: ~/.codex not found — skipped.");
-    }
+    const servers = config[topKey] ?? {};
+    if (servers.changebook)
+        return `${label}: already configured.`;
+    servers.changebook = entry;
+    config[topKey] = servers;
+    fs.mkdirSync(parent, { recursive: true });
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+    return `${label}: registered.`;
+}
+/** Platform path for Claude Desktop's config. */
+function claudeDesktopConfigPath() {
+    const home = os.homedir();
+    if (process.platform === "darwin")
+        return path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    if (process.platform === "win32")
+        return path.join(process.env.APPDATA ?? path.join(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
+    return path.join(home, ".config", "Claude", "claude_desktop_config.json");
+}
+export async function registerAgents(dir) {
+    const { command, args } = serverCommand();
+    const stdio = { command, args };
+    const home = os.homedir();
+    const done = [];
+    done.push(await registerClaudeCode(command, args));
+    done.push(registerCodex(command, args));
+    done.push(registerJsonAgent("Cursor", path.join(home, ".cursor", "mcp.json"), "mcpServers", stdio));
+    done.push(registerJsonAgent("Windsurf", path.join(home, ".codeium", "windsurf", "mcp_config.json"), "mcpServers", stdio));
+    done.push(registerJsonAgent("Claude Desktop", claudeDesktopConfigPath(), "mcpServers", stdio));
+    // VS Code (Copilot agent mode) reads a project-scoped .vscode/mcp.json and
+    // uses "servers" with an explicit transport type. Only if the project already
+    // has a .vscode dir, so init doesn't create one unasked.
+    done.push(registerJsonAgent("VS Code", path.join(dir, ".vscode", "mcp.json"), "servers", { type: "stdio", ...stdio }));
     return done;
 }
 //# sourceMappingURL=init.js.map

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "changebook",
-  "version": "0.2.0",
+  "version": "0.3.0",
+  "mcpName": "io.github.raulbr90/changebook",
   "description": "ChangeBook for coding agents: MCP server (product memory for Claude Code/Codex) + CLI to sign in, analyze changes and sync the product map.",
   "type": "module",
   "main": "dist/index.js",
@@ -11,7 +12,8 @@
   "files": [
     "dist",
     "!dist/**/*.map",
-    "README.md"
+    "README.md",
+    "server.json"
   ],
   "license": "MIT",
   "repository": {

package/server.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.raulbr90/changebook",
+  "description": "Query your product's living memory: module map + analyzed change history. Read-only MCP tools.",
+  "version": "0.3.0",
+  "repository": {
+    "url": "https://github.com/raulbr90/appatlas",
+    "source": "github"
+  },
+  "websiteUrl": "https://changebook.dev",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "changebook",
+      "version": "0.3.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}