@join-pantheon/cli 0.26.1 → 0.26.3

package/dist/doctor.js

@@ -5,7 +5,8 @@ import { grantsSeen, measureMcp, toolsReport, HOST_STARTUP_ALLOWANCE_MS, STARTUP
 import { FEEDBACK_ADDRESS } from "./feedback.js";
 import { loadProfile, profileInitialized } from "./profile.js";
 import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+import { homedir, platform } from "node:os";
+import { join, resolve } from "node:path";
 import { PantheonClient } from "./client.js";
 import { load, resolveFor, loadAll, CONFIG_PATH } from "./config.js";
 import { fingerprint, signChallenge, verifyChallenge } from "./identity.js";
@@ -16,17 +17,28 @@ import { workerProc, menubarProc, notifierProc } from "./machine.js";
 import { chooseAgent, describeChoice } from "./agents.js";
 import { onPathNamed } from "./which.js";
 import { VERSION } from "./version.js";
-import { serviceInstalled } from "./service.js";
-import { hostEnv } from "./host-env.js";
+import { serviceInstalled, servicesUnavailable } from "./service.js";
+import { hostEnv, platformName } from "./host-env.js";
 const HOSTED_RELAY = "relay.joinpantheon.network";
-const sh = (cmd, cwd) => {
+const git = (args, cwd) => {
     try {
-        return execFileSync("sh", ["-lc", cmd], { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+        return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
     }
     catch {
         return null;
     }
 };
+function claudeLocalOverride(projectDir) {
+    try {
+        const doc = JSON.parse(readFileSync(join(homedir(), ".claude.json"), "utf8"));
+        const norm = (x) => resolve(x).replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
+        const want = norm(projectDir);
+        return Object.entries(doc.projects ?? {}).some(([k, v]) => norm(k) === want && !!v?.mcpServers?.["pantheon"]);
+    }
+    catch {
+        return false;
+    }
+}
 function isPrivate(host) {
     const h = host.replace(/:\d+$/, "");
     if (/^(localhost|127\.0\.0\.1|\[::1\]|::1)$/.test(h))
@@ -56,10 +68,10 @@ export async function doctor(projectDir) {
         : add("fail", "node", `v${process.versions.node} is too old`, "pantheon needs Node 22 or newer (the relay uses node:sqlite) — install it and re-run", `v${process.versions.node}, too old`);
     const host = hostEnv();
     if (host.ephemeral) {
-        add("warn", "machine", `${host.platform} in ${host.kind === "container" ? "a container" : "a cloud workspace"} — ${host.evidence.join("; ")}`, `this is not the computer you work on, which is why it reports ${host.platform} to someone who may be sitting at a Mac. The team and your account are fine here, but the menu bar, desktop alerts and the worker belong on your own machine — run the setup from a terminal there.`, `${host.platform} in ${host.kind === "container" ? "a container" : "a cloud workspace"}`);
+        add("warn", "machine", `${platformName(host.platform)} in ${host.kind === "container" ? "a container" : "a cloud workspace"} — ${host.evidence.join("; ")}`, `this is not the computer you work on, which is why it reports ${platformName(host.platform)} to someone who may be sitting at a Mac. The team and your account are fine here, but the menu bar, desktop alerts and the worker belong on your own machine — run the setup from a terminal there.`, `${host.platform} in ${host.kind === "container" ? "a container" : "a cloud workspace"}`);
     }
     else {
-        add("pass", "machine", `${host.platform}${host.desktop ? " — menu bar and desktop alerts can run here" : " — no menu bar or desktop alerts (macOS only); use phone or chat delivery"}`, undefined, `${host.platform}${host.desktop ? ", desktop" : ""}`);
+        add("pass", "machine", `${platformName(host.platform)}${host.desktop ? " — menu bar and desktop alerts can run here" : " — no menu bar or desktop alerts (macOS only); use phone or chat delivery"}`, undefined, `${host.platform}${host.desktop ? ", desktop" : ""}`);
     }
     let cfg = null;
     try {
@@ -114,7 +126,15 @@ export async function doctor(projectDir) {
             add("fail", "mcp entry", ".mcp.json has no pantheon server", "run `pantheon install`", ".mcp.json has no pantheon server");
         }
         else if (entry.command === "pantheon") {
-            add("pass", "mcp entry", "portable (`pantheon mcp`) — safe to commit, works on your teammate's machine", undefined, "portable");
+            if (platform() !== "win32") {
+                add("pass", "mcp entry", "portable (`pantheon mcp`) — safe to commit, works on your teammate's machine", undefined, "portable");
+            }
+            else if (claudeLocalOverride(projectDir)) {
+                add("pass", "mcp entry", "portable (`pantheon mcp`) for your teammates; Claude Code on this Windows machine starts it through a local override for this folder", undefined, "portable, with a local override");
+            }
+            else {
+                add("warn", "mcp entry", "portable (`pantheon mcp`) — right for your teammates, but a Windows MCP host cannot start `pantheon` itself (it is pantheon.cmd, which needs a shell), so Claude Code shows pantheon as failed in this folder", "run `pantheon install` in this folder — it adds a local override for Claude Code here and leaves the committed file alone", "portable, no local override on Windows");
+            }
         }
         else {
             add("fail", "mcp entry", `hard-codes this machine: ${entry.command}`, "make sure `pantheon` is on your PATH, then run `pantheon install` again — it writes the portable `pantheon mcp` entry. Committed as-is it silently fails on the other machine: the MCP server never starts and no error is shown.", "hard-codes a path on this machine");
@@ -123,16 +143,16 @@ export async function doctor(projectDir) {
     onPath()
         ? add("pass", "PATH", "`pantheon` resolves by name", undefined, "pantheon resolves by name")
         : add("warn", "PATH", "`pantheon` is not on PATH", "install it globally (`npm install -g @join-pantheon/cli`) and make sure your npm global bin dir (`npm bin -g`) is on PATH", "pantheon is not on PATH");
-    const inRepo = sh("git rev-parse --is-inside-work-tree", projectDir) === "true";
+    const inRepo = git(["rev-parse", "--is-inside-work-tree"], projectDir) === "true";
     if (!inRepo) {
         add("warn", "git", `${projectDir} is not a git repo`, "DELIVERED requires a pushed branch + commit, so the work needs to live in a repo you both clone", "not a git repo");
     }
     else {
-        const remote = sh("git remote get-url origin", projectDir);
+        const remote = git(["remote", "get-url", "origin"], projectDir);
         remote
             ? add("pass", "git", `repo with origin ${remote}`, undefined, "repo with an origin remote")
             : add("fail", "git", "repo has no `origin` remote", "DELIVERED names a commit your teammate fetches. Without a shared remote they cannot verify anything you deliver.", "repo without an origin remote");
-        const branch = sh("git rev-parse --abbrev-ref HEAD", projectDir);
+        const branch = git(["rev-parse", "--abbrev-ref", "HEAD"], projectDir);
         if (branch)
             add("pass", "git branch", branch);
     }
@@ -255,7 +275,10 @@ export async function doctor(projectDir) {
             add("pass", "wake rights", `${who} — worker is running`, undefined, `${wakers.length} may wake; worker running`);
         }
         else {
-            add("warn", "wake rights", `${who}, but no worker is running here, so nothing can be woken`, "start one with `pantheon service install worker --project <a git repo>`; until then a peer's act waits for you to type", `${wakers.length} may wake; worker not running`);
+            const noSvc = servicesUnavailable(host.platform);
+            add("warn", "wake rights", `${who}, but no worker is running here, so nothing can be woken`, noSvc
+                ? "Pantheon does not run in the background on Windows yet, so a peer's act waits until your agent is open"
+                : "start one with `pantheon service install worker --project <a git repo>`; until then a peer's act waits for you to type", `${wakers.length} may wake; worker not running`);
         }
     }
     if (host.desktop) {

package/dist/host-env.js

@@ -40,9 +40,10 @@ export function hostEnv(env = process.env, plat = process.platform, exists = exi
         desktop: false,
     };
 }
+export const platformName = (p) => p === "win32" ? "Windows" : p === "darwin" ? "macOS" : p === "linux" ? "Linux" : p;
 export function ephemeralWarning(host) {
     return `this looks like ${host.kind === "container" ? "a container" : "a cloud workspace"}, not the computer you work on `
-        + `(${host.evidence.join("; ")}). That is why this machine reports ${host.platform}: your editor's agent is running `
+        + `(${host.evidence.join("; ")}). That is why this machine reports ${platformName(host.platform)}: your editor's agent is running `
         + `somewhere else, so the menu bar and desktop alerts cannot be installed, and anything installed here disappears with `
         + `the session. Your account and team are fine — run the same setup from a terminal on your own computer to finish it.`;
 }
@@ -50,8 +51,8 @@ export function desktopUnavailable(host, what) {
     if (host.desktop)
         return null;
     if (host.ephemeral) {
-        return `not available — ${what} ${what === "desktop alerts" ? "need" : "needs"} your own computer, and this is ${host.kind === "container" ? "a container" : "a cloud workspace"} reporting ${host.platform}`;
+        return `not available — ${what} ${what === "desktop alerts" ? "need" : "needs"} your own computer, and this is ${host.kind === "container" ? "a container" : "a cloud workspace"} reporting ${platformName(host.platform)}`;
     }
-    return `not available — ${what} ${host.platform === "darwin" ? "could not be built here" : `${what === "desktop alerts" ? "are" : "is"} macOS-only, and this machine is ${host.platform}`}`;
+    return `not available — ${what} ${host.platform === "darwin" ? "could not be built here" : `${what === "desktop alerts" ? "are" : "is"} macOS-only, and this machine is ${platformName(host.platform)}`}`;
 }
 //# sourceMappingURL=host-env.js.map

package/dist/install.js

@@ -8,6 +8,7 @@ import { PANTHEON_TOOL_NAMES, WRITE_TOOL_NAMES } from "./tools.js";
 import { load } from "./config.js";
 import { loadProfile } from "./profile.js";
 import { agentSpawn, onPathNamed, which } from "./which.js";
+import { FEEDBACK_ADDRESS } from "./feedback.js";
 const HERE = dirname(fileURLToPath(import.meta.url));
 export function onPath() {
     return onPathNamed("pantheon");
@@ -114,10 +115,11 @@ function upsertBrief(file, cfg) {
     writeFileSync(file, cur.trimEnd() + "\n\n" + block + "\n");
     return "updated";
 }
-export function install(projectDir, cfg, force) {
+export function install(projectDir, cfg, force, os = platform(), claudeLocal = claudeLocalScope) {
     const out = [];
-    const l = launcher(force);
-    const entry = { command: l.command, args: l.args };
+    const l = launcher(force, os);
+    const win = os === "win32";
+    const entry = win ? { command: "pantheon", args: ["mcp"] } : { command: l.command, args: l.args };
     out.push(`  .mcp.json                 ${mergeMcpJson(join(projectDir, ".mcp.json"), entry)}   (claude code, conductor, copilot cli)`);
     out.push(`  .cursor/mcp.json          ${mergeMcpJson(join(projectDir, ".cursor", "mcp.json"), entry)}   (cursor)`);
     const vscodeDir = join(projectDir, ".vscode");
@@ -137,7 +139,15 @@ export function install(projectDir, cfg, force) {
     for (const line of codexTomlBlock(userEntry()).split("\n"))
         out.push(`    ${line}`);
     out.push("");
-    if (l.portable) {
+    if (win) {
+        const local = claudeLocal(userEntry(os), projectDir);
+        out.push("  \x1b[36mPortable entry\x1b[0m — `pantheon mcp` is what your teammates' machines start, so this config is safe to commit.");
+        out.push("  Windows cannot start it from an MCP host (pantheon is pantheon.cmd here, and hosts use no shell), so this");
+        out.push("  machine gets its own way in, outside the repo:");
+        out.push(`    claude code   ${local.status}`);
+        out.push(`    cursor        your user-level entry from \`pantheon join\`; if Pantheon does not appear in Cursor for this folder, say so: ${FEEDBACK_ADDRESS}`);
+    }
+    else if (l.portable) {
         out.push("  \x1b[36mPortable entry\x1b[0m — `pantheon` resolves on PATH, so this config is safe to commit");
         out.push("  and will work in every Conductor workspace and on your teammate's machine.");
     }
@@ -198,6 +208,25 @@ function claudeUserScope(entry) {
         return { tool, where: "user scope", status: `failed: ${e.message.split("\n")[0]}` };
     }
 }
+function claudeLocalScope(entry, projectDir) {
+    const tool = "claude code";
+    const claudeBin = which("claude");
+    if (!claudeBin)
+        return { tool, where: "-", status: "skipped (claude not on PATH) — once Claude Code is installed, run `pantheon install` here again" };
+    try {
+        const remove = agentSpawn(claudeBin, ["mcp", "remove", "pantheon", "-s", "local"]);
+        const add = agentSpawn(claudeBin, ["mcp", "add", "pantheon", "-s", "local", "--", entry.command, ...entry.args]);
+        try {
+            execFileSync(remove.command, remove.args, { stdio: "ignore", cwd: projectDir, ...remove.options });
+        }
+        catch { }
+        execFileSync(add.command, add.args, { stdio: "ignore", cwd: projectDir, ...add.options });
+        return { tool, where: "local scope, this folder", status: "local override written — Claude Code starts pantheon here with this machine's node, and nothing in the repo changed" };
+    }
+    catch (e) {
+        return { tool, where: "local scope", status: `failed: ${e.message.split("\n")[0]}` };
+    }
+}
 function cursorUserScope(entry) {
     const file = join(homedir(), ".cursor", "mcp.json");
     try {

package/dist/notify.js

@@ -1,13 +1,22 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
+import { homedir, platform } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { whichPantheon } from "./service.js";
 import { detectForHooks, agentById } from "./agents.js";
 import { codexHookState, cursorHookState, copilotHookState, installCodexHooks, installCursorHooks, installCopilotHooks, removeCodexHooks, removeCursorHooks, removeCopilotHooks, } from "./hooks-install.js";
 export const HOOK_MARKER = "pantheon hook";
-export const HOOK_RE = /pantheon(?:\.cmd|\.exe|\.bat)?"?\s+hook\s/i;
+export const HOOK_RE = /(?:pantheon(?:\.cmd|\.exe|\.bat)?"?\s+hook\s|cli\.js"?\s+hook\s+(?:stop|prompt|end|codex-stop|copilot-stop|cursor-stop)\b)/i;
 export const isOurHookCommand = (cmd) => !!cmd && (cmd.includes(HOOK_MARKER) || HOOK_RE.test(cmd));
 export const hookBin = (bin) => (/\s/.test(bin) ? `"${bin}"` : bin);
+const HERE = dirname(fileURLToPath(import.meta.url));
+export function hookLauncher(os = platform(), found = whichPantheon(), entry = resolve(HERE, "cli.js"), entryExists = existsSync) {
+    if (os !== "win32")
+        return found ? hookBin(found) : null;
+    if (entryExists(entry))
+        return `node "${entry.replace(/\\/g, "/")}"`;
+    return found ? hookBin(found) : null;
+}
 export function settingsPath(scope, projectDir = process.cwd()) {
     return scope === "user"
         ? join(homedir(), ".claude", "settings.json")
@@ -140,10 +149,9 @@ export function repairHook(home) {
 function installClaudeHook(scope, projectDir = process.cwd()) {
     const file = settingsPath(scope, projectDir);
     const doc = read(file);
-    const found = whichPantheon();
-    if (!found)
+    const bin = hookLauncher();
+    if (!bin)
         throw new Error("pantheon binary not found on PATH");
-    const bin = hookBin(found);
     const events = {
         Stop: `${bin} hook stop`,
         UserPromptSubmit: `${bin} hook prompt`,
@@ -168,7 +176,7 @@ function installClaudeHook(scope, projectDir = process.cwd()) {
     ];
 }
 export function installHooks(scope, projectDir = process.cwd(), only) {
-    const bin = whichPantheon();
+    const bin = hookLauncher();
     if (!bin)
         throw new Error("pantheon binary not found on PATH");
     const available = detectForHooks(projectDir);

package/dist/quickstart.js

@@ -9,7 +9,7 @@ import { newKeypair } from "./identity.js";
 import { installForUser } from "./install.js";
 import { writeIntent, installHooks } from "./notify.js";
 import { detectAvailable, agentById } from "./agents.js";
-import { installService } from "./service.js";
+import { installService, servicesUnavailable } from "./service.js";
 import { ensureNativeNotifier } from "./notifier.js";
 import { ensureTrayBinary, writeTrayCommands } from "./tray.js";
 import { desktopUnavailable, ephemeralWarning, hostEnv } from "./host-env.js";
@@ -30,6 +30,7 @@ export function wireUp(opts, deps = {}) {
     const ensureNotifier = deps.ensureNotifier ?? ensureNativeNotifier;
     const ensureTray = deps.ensureTray ?? ensureTrayBinary;
     const host = deps.host ?? hostEnv();
+    const noServices = servicesUnavailable(host.platform);
     const tools = installForUser().map((t) => ({ tool: t.tool, status: t.status }));
     const granted = [];
     const warnings = [];
@@ -92,6 +93,9 @@ export function wireUp(opts, deps = {}) {
     if (how === "off") {
         tools.push({ tool: "worker", status: "off (--no-worker) — this machine cannot answer the team while you are away" });
     }
+    else if (opts.unattended && noServices) {
+        tools.push({ tool: "worker", status: noServices });
+    }
     else if (opts.unattended) {
         const project = opts.unattended;
         const isRepo = sh(`git -C ${JSON.stringify(project)} rev-parse --is-inside-work-tree 2>/dev/null`) === "true";

package/dist/service.js

@@ -13,6 +13,12 @@ const SERVICE_BASE_PATH = [
 export function servicePath(envPath = process.env.PATH ?? "") {
     return [...new Set([...envPath.split(":"), ...SERVICE_BASE_PATH].filter(Boolean))].join(":");
 }
+export function servicesUnavailable(plat = platform()) {
+    if (plat !== "win32")
+        return null;
+    return "not available — Pantheon does not run in the background on Windows yet. "
+        + "Your agent still answers peers whenever it is open; nothing runs here while you are away.";
+}
 export function plistPath(kind = "worker") {
     return join(homedir(), "Library", "LaunchAgents", `${LABEL(kind)}.plist`);
 }
@@ -87,6 +93,9 @@ WantedBy=default.target
 `;
 }
 export function installService(kind, cwd, args) {
+    const noServices = servicesUnavailable();
+    if (noServices)
+        throw new Error(noServices.replace(/^not available — /, ""));
     const out = [];
     const abs = resolve(cwd);
     const logDir = join(abs, ".pantheon");
@@ -134,6 +143,14 @@ export function installService(kind, cwd, args) {
 }
 export function uninstallService(kind) {
     const out = [];
+    if (platform() === "win32") {
+        const stray = unitPath(kind);
+        if (existsSync(stray)) {
+            unlinkSync(stray);
+            return [`  removed ${stray}`];
+        }
+        return [`  no ${kind} service installed`];
+    }
     if (platform() === "darwin") {
         const p = plistPath(kind);
         if (!existsSync(p))
@@ -188,6 +205,8 @@ export function restartService(kind, exec = (c, a) => execFileSync(c, a, { stdio
 }
 export function serviceInstalled(kind) {
     try {
+        if (platform() === "win32")
+            return false;
         return existsSync(platform() === "darwin" ? plistPath(kind) : unitPath(kind));
     }
     catch {

package/dist/update-check.js

@@ -4,6 +4,7 @@ import { dirname, join } from "node:path";
 import { CONFIG_DIR } from "./config.js";
 import { repoRoot, PKG_NAME } from "./upgrade.js";
 import { VERSION } from "./version.js";
+import { npmSpawn } from "./which.js";
 export function semverGt(x, y) {
     const p = (s) => s.split(".").map((n) => Number(n) || 0);
     const [a, b] = [p(x), p(y)];
@@ -80,7 +81,8 @@ export function defaultDeps(home) {
         },
         npmLatest: () => {
             try {
-                return execFileSync("npm", ["view", PKG_NAME, "version"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 4000 }).trim() || null;
+                const s = npmSpawn(["view", PKG_NAME, "version"]);
+                return execFileSync(s.command, s.args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 4000, ...s.options }).trim() || null;
             }
             catch {
                 return null;

package/dist/upgrade.js

@@ -3,6 +3,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { installForUser } from "./install.js";
+import { npmSpawn } from "./which.js";
 import { relayProc, workerProc, notifierProc, menubarProc } from "./machine.js";
 export function repoRoot() {
     return join(dirname(fileURLToPath(import.meta.url)), "..");
@@ -28,6 +29,10 @@ export function rewireVia(root, fallback, run = (file, args) => execFileSync(pro
 }
 export function defaultDeps() {
     const git = (root, ...args) => execFileSync("git", ["-C", root, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+    const npm = (args, opts) => {
+        const s = npmSpawn(args);
+        return execFileSync(s.command, s.args, { encoding: "utf8", ...opts, ...s.options });
+    };
     return {
         root: repoRoot(),
         isGit: (root) => existsSync(join(root, ".git")),
@@ -37,7 +42,7 @@ export function defaultDeps() {
         fetch: (root) => { git(root, "fetch", "--quiet"); },
         behind: (root) => Number(git(root, "rev-list", "--count", "HEAD..@{u}")) || 0,
         pull: (root) => git(root, "pull", "--ff-only"),
-        build: (root) => execFileSync("npm", ["install", "--no-audit", "--no-fund"], { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }),
+        build: (root) => npm(["install", "--no-audit", "--no-fund"], { cwd: root, stdio: ["ignore", "pipe", "pipe"] }),
         version: pkgVersion,
         rewire: () => rewireVia(repoRoot(), () => installForUser().map((t) => ({ tool: t.tool, status: t.status }))),
         running: () => {
@@ -64,10 +69,10 @@ export function defaultDeps() {
             catch { }
             return up;
         },
-        npmUpgrade: () => execFileSync("npm", ["install", "-g", `${PKG_NAME}@latest`, "--no-audit", "--no-fund"], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }),
+        npmUpgrade: () => npm(["install", "-g", `${PKG_NAME}@latest`, "--no-audit", "--no-fund"], { stdio: ["ignore", "pipe", "pipe"] }),
         npmLatest: () => {
             try {
-                return execFileSync("npm", ["view", `${PKG_NAME}`, "version"], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 4000 }).trim() || null;
+                return npm(["view", `${PKG_NAME}`, "version"], { stdio: ["ignore", "pipe", "ignore"], timeout: 4000 }).trim() || null;
             }
             catch {
                 return null;

package/dist/which.js

@@ -1,6 +1,6 @@
 import { execFileSync } from "node:child_process";
 import { accessSync, constants, existsSync, statSync } from "node:fs";
-import { win32 } from "node:path";
+import { posix, win32 } from "node:path";
 import { platform } from "node:os";
 export const DEFAULT_PATHEXT = ".COM;.EXE;.BAT;.CMD;.VBS;.JS;.PS1";
 const isWindows = (os = platform()) => os === "win32";
@@ -43,6 +43,23 @@ export function whichWindows(name, env = process.env, exists = runnable) {
 export function which(name, os = platform(), env = process.env) {
     if (isWindows(os))
         return whichWindows(name, env);
+    return loginShellWhich(name) ?? posixOnPath(name, env);
+}
+function posixOnPath(name, env) {
+    if (!name)
+        return null;
+    if (name.includes("/"))
+        return runnable(name) ? name : null;
+    for (const dir of (env.PATH ?? "").split(":")) {
+        if (!dir)
+            continue;
+        const full = posix.join(dir, name);
+        if (runnable(full))
+            return full;
+    }
+    return null;
+}
+function loginShellWhich(name) {
     try {
         const out = execFileSync("sh", ["-lc", `command -v ${name}`], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
         if (!out)
@@ -59,6 +76,11 @@ export function spawnShape(binary, os = platform()) {
         return { command: binary, shell: false };
     return { command: binary, shell: /\.(cmd|bat)$/i.test(binary) };
 }
+export function npmSpawn(args, os = platform(), resolveNpm = () => which("npm", os)) {
+    if (!isWindows(os))
+        return { command: "npm", args: [...args], options: {} };
+    return agentSpawn(resolveNpm() ?? "npm.cmd", args, os);
+}
 const cmdQuote = (a) => (/[\s"&|<>^()]/.test(a) || a === "" ? `"${a.replace(/"/g, '\\"')}"` : a);
 export function agentSpawn(binary, args, os = platform()) {
     if (!isWindows(os) || !/\.(cmd|bat)$/i.test(binary))

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@join-pantheon/cli",
-  "version": "0.26.1",
-  "description": "Let your coding agent collaborate directly with your teammates' agents \u2014 ask, agree an interface, and deliver, without a human relaying messages.",
+  "version": "0.26.3",
+  "description": "Let your coding agent collaborate directly with your teammates' agents — ask, agree an interface, and deliver, without a human relaying messages.",
   "type": "module",
   "bin": {
     "pantheon": "bin/pantheon.js"