mcp-walkthrough 0.1.6 → 0.2.1

package/README.md

@@ -19,7 +19,7 @@ Text in a terminal isn't enough when you want Claude to explain a solution. MCP
 - **Selection Reading** — Claude can see what you've highlighted to discuss it further
 - **Focus Preservation** — Opens files without stealing focus from your terminal
 
-> **Note:** This MCP server requires VS Code. It includes a companion VS Code extension that is automatically installed when you `npm install`.
+> **Note:** This MCP server requires VS Code, VS Code Insiders, or Cursor. It includes a companion VS Code extension that is automatically installed when you `npm install`. The CLI is auto-discovered even if `code` is not in your PATH.
 
 ## Installation
 
@@ -144,15 +144,16 @@ Explanations render as markdown in VS Code comment bubbles. Tips:
 ## How It Works
 
 ```
-Claude Code  →  MCP Server (stdio)  →  HTTP localhost:7890  →  VS Code Extension  →  Editor API
+Claude Code  →  MCP Server (stdio)  →  Unix socket  →  VS Code Extension  →  Editor API
 ```
 
 1. Claude calls walkthrough tools via MCP
-2. The MCP server forwards requests to a companion VS Code extension over HTTP
-3. The extension uses the VS Code API to open files, select ranges, and create comment threads
-4. Focus stays in your terminal — code appears in the editor beside it
+2. The MCP server discovers a workspace-specific Unix socket (`/tmp/walkthrough-bridge-<hash>.sock`)
+3. The VS Code extension listens on a socket derived from the workspace folder path
+4. Each VS Code window gets its own socket — multiple windows work independently
+5. Focus stays in your terminal — code appears in the editor beside it
 
-The VS Code extension is bundled with the npm package and automatically installed on first run.
+The VS Code extension is bundled with the npm package and automatically installed on `npm install` and on first server start. The CLI is auto-discovered across VS Code, VS Code Insiders, and Cursor on all platforms.
 
 ## Development
 
@@ -162,15 +163,22 @@ The VS Code extension is bundled with the npm package and automatically installe
 mcp-walkthrough/
 ├── src/
 │   ├── index.ts              # MCP server entry point, tool registration
-│   ├── bridge.ts             # HTTP client to VS Code extension
+│   ├── bridge.ts             # Unix socket client to VS Code extension
+│   ├── code-cli.ts           # Cross-platform VS Code CLI discovery
+│   ├── socket.ts             # Socket path computation and discovery
 │   └── utils/
 │       └── logger.ts         # Pino logger (stderr only)
+├── scripts/
+│   └── postinstall.cjs       # Auto-installs extension on npm install
 ├── vscode-extension/
 │   ├── src/
 │   │   └── extension.ts      # VS Code extension (HTTP server, Comments API)
 │   └── package.json
 ├── tests/
-│   └── bridge.test.ts
+│   ├── bridge.test.ts
+│   ├── code-cli.test.ts
+│   ├── postinstall.test.ts
+│   └── socket.test.ts
 └── docs/
 ```
 
@@ -194,19 +202,26 @@ The build script syncs the version from root `package.json` into the extension b
 
 ## Troubleshooting
 
-### Tools return "This MCP server only works from VS Code."
+### Tools return "No walkthrough bridge socket found"
 
-The MCP server pings the VS Code extension on startup. If the extension isn't running:
+The MCP server discovers the VS Code extension via a Unix socket. If the socket isn't found:
 
 1. Make sure you're running Claude Code inside VS Code (not a standalone terminal)
 2. The extension activates on VS Code startup — try reloading the window (`Cmd+Shift+P` → "Reload Window")
+3. The socket is workspace-specific — make sure the VS Code window has a folder open
 
 ### Extension not installed
 
-The MCP server auto-installs the extension on first run via `code --install-extension`. If this fails:
+The MCP server auto-discovers VS Code, VS Code Insiders, and Cursor CLIs — even when `code` isn't in your PATH. It searches:
 
-1. Verify the `code` CLI is available in your terminal
-2. Manually install: `code --install-extension path/to/walkthrough-bridge.vsix`
+- **macOS**: `/Applications/*.app/Contents/Resources/app/bin/`
+- **Linux**: `/usr/bin/`, `/usr/local/bin/`, `/snap/bin/`, `/opt/*/bin/`
+- **Windows**: `%LOCALAPPDATA%\Programs\*\bin\`
+
+The extension is installed into **all** found editors. If auto-install still fails:
+
+1. Manually install: `code --install-extension path/to/walkthrough-bridge.vsix`
+2. Or reload the VS Code window after installing the npm package
 
 ## Contributing
 

package/dist/bridge.d.ts

@@ -2,6 +2,7 @@ export declare function ensureExtensionInstalled(): void;
 type BridgeResult = Record<string, unknown>;
 export declare let bridgeAvailable: boolean | null;
 export declare function resetBridgeState(): void;
+export declare function _setSocketPath(path: string): void;
 export declare function checkBridge(): Promise<boolean>;
 export declare function isBridgeAvailable(): boolean;
 export declare function openFile(file: string, line: number, endLine?: number, startChar?: number, endChar?: number): Promise<BridgeResult>;

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAgBA,wBAAgB,wBAAwB,IAAI,IAAI,CAsB/C;AAED,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5C,eAAO,IAAI,eAAe,EAAE,OAAO,GAAG,IAAW,CAAC;AAElD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAcpD;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAuBD,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,YAAY,CAAC,CAE/D;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EAAE,EACxB,QAAQ,CAAC,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,YAAY,CAAC,CAElE;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAE1D"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAkBA,wBAAgB,wBAAwB,IAAI,IAAI,CAoC/C;AAED,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5C,eAAO,IAAI,eAAe,EAAE,OAAO,GAAG,IAAW,CAAC;AAGlD,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAGD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AA+DD,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAKpD;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,YAAY,CAAC,CAE/D;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EAAE,EACxB,QAAQ,CAAC,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,YAAY,CAAC,CAElE;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAE1D"}

package/dist/bridge.js

@@ -1,81 +1,122 @@
 import { execSync } from "node:child_process";
 import { existsSync } from "node:fs";
+import * as http from "node:http";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { resolveAllCodeClis } from "./code-cli.js";
+import { discoverSocket } from "./socket.js";
 import { logger } from "./utils/logger.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const EXTENSION_ID = "undefined_publisher.walkthrough-bridge";
 const VSIX_PATH = join(__dirname, "../vscode-extension/walkthrough-bridge.vsix");
-const BRIDGE_URL = "http://127.0.0.1:7890";
 export function ensureExtensionInstalled() {
-    try {
-        const installed = execSync("code --list-extensions", { encoding: "utf-8" });
-        if (installed.includes(EXTENSION_ID)) {
-            logger.info("Walkthrough bridge extension already installed");
-            return;
-        }
-    }
-    catch {
-        logger.warn("Could not check installed extensions");
+    const clis = resolveAllCodeClis();
+    if (clis.length === 0) {
+        logger.warn("Could not find VS Code CLI (code, code-insiders, or cursor). Install one or add it to PATH.");
+        return;
     }
     if (!existsSync(VSIX_PATH)) {
         logger.error({ path: VSIX_PATH }, "Extension .vsix not found");
         return;
     }
-    try {
-        execSync(`code --install-extension "${VSIX_PATH}"`, { encoding: "utf-8" });
-        logger.info("Installed walkthrough bridge extension");
-    }
-    catch (error) {
-        logger.error({ err: error }, "Failed to install extension");
+    for (const cli of clis) {
+        try {
+            const installed = execSync(`"${cli}" --list-extensions`, {
+                encoding: "utf-8",
+            });
+            if (installed.includes(EXTENSION_ID)) {
+                logger.info({ cli }, "Walkthrough bridge extension already installed");
+                continue;
+            }
+        }
+        catch {
+            logger.warn({ cli }, "Could not check installed extensions");
+        }
+        try {
+            execSync(`"${cli}" --install-extension "${VSIX_PATH}"`, {
+                encoding: "utf-8",
+            });
+            logger.info({ cli }, "Installed walkthrough bridge extension");
+        }
+        catch (error) {
+            logger.error({ cli, err: error }, "Failed to install extension");
+        }
     }
 }
 export let bridgeAvailable = null;
+let socketPath = null;
 export function resetBridgeState() {
     bridgeAvailable = null;
+    socketPath = null;
 }
-export async function checkBridge() {
-    try {
-        const res = await fetch(`${BRIDGE_URL}/ping`, {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: "{}",
-        });
-        const data = (await res.json());
-        bridgeAvailable = data.ok === true;
+// For testing: override socket path discovery
+export function _setSocketPath(path) {
+    socketPath = path;
+}
+function resolveSocketPath() {
+    if (!socketPath) {
+        socketPath = discoverSocket();
     }
-    catch {
-        bridgeAvailable = false;
+    return socketPath;
+}
+function socketRequest(endpoint, data = {}) {
+    const resolved = resolveSocketPath();
+    if (!resolved) {
+        return Promise.resolve({
+            ok: false,
+            error: "No walkthrough bridge socket found. Make sure VS Code is open with a workspace.",
+        });
     }
+    return new Promise((resolve) => {
+        const body = JSON.stringify(data);
+        const req = http.request({
+            socketPath: resolved,
+            path: endpoint,
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(body),
+            },
+        }, (res) => {
+            let responseData = "";
+            res.on("data", (chunk) => {
+                responseData += chunk.toString();
+            });
+            res.on("end", () => {
+                try {
+                    bridgeAvailable = true;
+                    resolve(JSON.parse(responseData));
+                }
+                catch {
+                    resolve({ ok: false, error: "Invalid response from bridge" });
+                }
+            });
+        });
+        req.on("error", () => {
+            resolve({
+                ok: false,
+                error: "Could not reach VS Code. Make sure VS Code is open and reload the window if you just installed mcp-walkthrough.",
+            });
+        });
+        req.write(body);
+        req.end();
+    });
+}
+export async function checkBridge() {
+    const result = await socketRequest("/ping");
+    bridgeAvailable = result.ok === true;
     logger.info({ bridgeAvailable }, "Bridge status");
     return bridgeAvailable;
 }
 export function isBridgeAvailable() {
     return bridgeAvailable === true;
 }
-async function bridgeRequest(endpoint, data = {}) {
-    try {
-        const res = await fetch(`${BRIDGE_URL}${endpoint}`, {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify(data),
-        });
-        bridgeAvailable = true;
-        return (await res.json());
-    }
-    catch {
-        return {
-            ok: false,
-            error: "Could not reach VS Code. Make sure VS Code is open and reload the window if you just installed mcp-walkthrough.",
-        };
-    }
-}
 export async function openFile(file, line, endLine, startChar, endChar) {
-    return bridgeRequest("/open", { file, line, endLine, startChar, endChar });
+    return socketRequest("/open", { file, line, endLine, startChar, endChar });
 }
 export async function showExplanation(file, line, endLine, explanation, title, startChar, endChar) {
-    return bridgeRequest("/explain", {
+    return socketRequest("/explain", {
         file,
         line,
         endLine,
@@ -86,18 +127,18 @@ export async function showExplanation(file, line, endLine, explanation, title, s
     });
 }
 export async function clearExplanations() {
-    return bridgeRequest("/clear");
+    return socketRequest("/clear");
 }
 export async function startWalkthrough(steps, autoplay, delayMs) {
-    return bridgeRequest("/walkthrough", { steps, autoplay, delayMs });
+    return socketRequest("/walkthrough", { steps, autoplay, delayMs });
 }
 export async function navigateWalkthrough(action, step) {
-    return bridgeRequest("/walkthrough/navigate", { action, step });
+    return socketRequest("/walkthrough/navigate", { action, step });
 }
 export async function getWalkthroughStatus() {
-    return bridgeRequest("/walkthrough/status");
+    return socketRequest("/walkthrough/status");
 }
 export async function getSelection() {
-    return bridgeRequest("/selection");
+    return socketRequest("/selection");
 }
 //# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}

package/dist/code-cli.d.ts

@@ -0,0 +1,4 @@
+export declare function _findAllCodeClis(platform: NodeJS.Platform, findInPath: (name: string) => string | null, fileExists: (path: string) => boolean, listDir: (path: string) => string[], localAppData?: string): string[];
+export declare function resolveAllCodeClis(): string[];
+export declare function resetCodeCliCache(): void;
+//# sourceMappingURL=code-cli.d.ts.map

package/dist/code-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-cli.d.ts","sourceRoot":"","sources":["../src/code-cli.ts"],"names":[],"mappings":"AAkBA,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,EAC3C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,EACnC,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,EAAE,CAiEV;AAgBD,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAS7C;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/code-cli.js

@@ -0,0 +1,86 @@
+import { execSync } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const CLI_NAMES = ["code", "code-insiders", "cursor"];
+function safeListDir(listDir, path) {
+    try {
+        return listDir(path);
+    }
+    catch {
+        return [];
+    }
+}
+export function _findAllCodeClis(platform, findInPath, fileExists, listDir, localAppData) {
+    const found = [];
+    for (const name of CLI_NAMES) {
+        const p = findInPath(name);
+        if (p)
+            found.push(p);
+    }
+    if (platform === "darwin") {
+        for (const entry of safeListDir(listDir, "/Applications")) {
+            if (!entry.endsWith(".app"))
+                continue;
+            for (const name of CLI_NAMES) {
+                const bin = join("/Applications", entry, "Contents", "Resources", "app", "bin", name);
+                if (fileExists(bin))
+                    found.push(bin);
+            }
+        }
+    }
+    if (platform === "linux") {
+        for (const dir of ["/usr/bin", "/usr/local/bin", "/snap/bin"]) {
+            for (const name of CLI_NAMES) {
+                const bin = join(dir, name);
+                if (fileExists(bin))
+                    found.push(bin);
+            }
+        }
+        for (const entry of safeListDir(listDir, "/opt")) {
+            for (const name of CLI_NAMES) {
+                const bin = join("/opt", entry, "bin", name);
+                if (fileExists(bin))
+                    found.push(bin);
+            }
+        }
+    }
+    if (platform === "win32") {
+        const appData = localAppData ||
+            process.env.LOCALAPPDATA ||
+            join(homedir(), "AppData", "Local");
+        const programsDir = join(appData, "Programs");
+        for (const entry of safeListDir(listDir, programsDir)) {
+            for (const name of CLI_NAMES) {
+                const std = join(programsDir, entry, "bin", `${name}.cmd`);
+                if (fileExists(std))
+                    found.push(std);
+                const electron = join(programsDir, entry, "resources", "app", "bin", `${name}.cmd`);
+                if (fileExists(electron))
+                    found.push(electron);
+            }
+        }
+    }
+    return [...new Set(found)];
+}
+function defaultFindInPath(name) {
+    try {
+        const cmd = process.platform === "win32" ? "where" : "which";
+        return (execSync(`${cmd} ${name}`, { encoding: "utf-8", stdio: "pipe" }).trim() ||
+            null);
+    }
+    catch {
+        return null;
+    }
+}
+let cached;
+export function resolveAllCodeClis() {
+    if (cached !== undefined)
+        return cached;
+    cached = _findAllCodeClis(process.platform, defaultFindInPath, existsSync, (p) => readdirSync(p));
+    return cached;
+}
+export function resetCodeCliCache() {
+    cached = undefined;
+}
+//# sourceMappingURL=code-cli.js.map

package/dist/code-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-cli.js","sourceRoot":"","sources":["../src/code-cli.ts"],"names":[],"mappings":"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"}

package/dist/socket.d.ts

@@ -0,0 +1,3 @@
+export declare function socketPathForDir(dir: string): string;
+export declare function discoverSocket(cwd?: string): string | null;
+//# sourceMappingURL=socket.d.ts.map

package/dist/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../src/socket.ts"],"names":[],"mappings":"AAOA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAYzE"}

package/dist/socket.js

@@ -0,0 +1,28 @@
+import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+const SOCKET_DIR = "/tmp";
+const SOCKET_PREFIX = "walkthrough-bridge-";
+export function socketPathForDir(dir) {
+    const normalized = dir.replace(/\/+$/, "");
+    const hash = createHash("sha256")
+        .update(normalized)
+        .digest("hex")
+        .slice(0, 16);
+    return join(SOCKET_DIR, `${SOCKET_PREFIX}${hash}.sock`);
+}
+export function discoverSocket(cwd = process.cwd()) {
+    let dir = cwd;
+    while (true) {
+        const socketPath = socketPathForDir(dir);
+        if (existsSync(socketPath)) {
+            return socketPath;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+//# sourceMappingURL=socket.js.map

package/dist/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../src/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAE5C,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,UAAU,CAAC;SAClB,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,IAAI,CAAC,UAAU,EAAE,GAAG,aAAa,GAAG,IAAI,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACxD,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-walkthrough",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "description": "MCP server for interactive code walkthroughs - Claude-driven code tours",
   "type": "module",
   "main": "dist/index.js",
@@ -9,6 +9,7 @@
   },
   "files": [
     "dist",
+    "scripts/postinstall.cjs",
     "vscode-extension/walkthrough-bridge.vsix",
     "README.md",
     "LICENSE"
@@ -29,7 +30,7 @@
   "scripts": {
     "build": "npm run build:extension && tsc -p tsconfig.build.json",
     "build:extension": "node -e \"const fs=require('fs');const v=require('./package.json').version;const p=JSON.parse(fs.readFileSync('vscode-extension/package.json','utf-8'));p.version=v;fs.writeFileSync('vscode-extension/package.json',JSON.stringify(p,null,2)+'\\n')\" && cd vscode-extension && npm install && npx tsc -p ./ && npx @vscode/vsce package --allow-missing-repository -o walkthrough-bridge.vsix",
-    "postinstall": "node -e \"try{require('child_process').execSync('code --install-extension '+require('path').join(__dirname,'vscode-extension','walkthrough-bridge.vsix')+' --force',{stdio:'ignore'})}catch{}\"",
+    "postinstall": "node scripts/postinstall.cjs",
     "dev": "bun --watch src/index.ts",
     "start": "node dist/index.js",
     "test": "bun test",

package/scripts/postinstall.cjs

@@ -0,0 +1,98 @@
+const { execSync } = require("node:child_process");
+const { existsSync, readdirSync } = require("node:fs");
+const { join } = require("node:path");
+
+const vsixPath = join(
+  __dirname,
+  "..",
+  "vscode-extension",
+  "walkthrough-bridge.vsix",
+);
+if (!existsSync(vsixPath)) process.exit(0);
+
+const cliNames = ["code", "code-insiders", "cursor"];
+const whichCmd = process.platform === "win32" ? "where" : "which";
+
+function safeReaddir(dir) {
+  try {
+    return readdirSync(dir);
+  } catch {
+    return [];
+  }
+}
+
+const found = [];
+
+for (const name of cliNames) {
+  try {
+    const p = execSync(`${whichCmd} ${name}`, {
+      encoding: "utf-8",
+      stdio: "pipe",
+    }).trim();
+    if (p) found.push(p);
+  } catch {}
+}
+
+if (process.platform === "darwin") {
+  for (const entry of safeReaddir("/Applications")) {
+    if (!entry.endsWith(".app")) continue;
+    for (const name of cliNames) {
+      const bin = join(
+        "/Applications",
+        entry,
+        "Contents",
+        "Resources",
+        "app",
+        "bin",
+        name,
+      );
+      if (existsSync(bin)) found.push(bin);
+    }
+  }
+}
+
+if (process.platform === "linux") {
+  for (const dir of ["/usr/bin", "/usr/local/bin", "/snap/bin"]) {
+    for (const name of cliNames) {
+      const bin = join(dir, name);
+      if (existsSync(bin)) found.push(bin);
+    }
+  }
+  for (const entry of safeReaddir("/opt")) {
+    for (const name of cliNames) {
+      const bin = join("/opt", entry, "bin", name);
+      if (existsSync(bin)) found.push(bin);
+    }
+  }
+}
+
+if (process.platform === "win32") {
+  const appData =
+    process.env.LOCALAPPDATA ||
+    join(require("node:os").homedir(), "AppData", "Local");
+  const programsDir = join(appData, "Programs");
+  for (const entry of safeReaddir(programsDir)) {
+    for (const name of cliNames) {
+      const std = join(programsDir, entry, "bin", `${name}.cmd`);
+      if (existsSync(std)) found.push(std);
+      const electron = join(
+        programsDir,
+        entry,
+        "resources",
+        "app",
+        "bin",
+        `${name}.cmd`,
+      );
+      if (existsSync(electron)) found.push(electron);
+    }
+  }
+}
+
+const unique = [...new Set(found)];
+for (const cli of unique) {
+  try {
+    execSync(`"${cli}" --install-extension "${vsixPath}" --force`, {
+      stdio: "ignore",
+    });
+  } catch {}
+}