@join-pantheon/cli 0.25.3 → 0.26.1

package/dist/hooks-install.js

@@ -1,9 +1,10 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
-import { HOOK_MARKER, MAX_CONSECUTIVE_BLOCKS } from "./notify.js";
+import { MAX_CONSECUTIVE_BLOCKS, isOurHookCommand } from "./notify.js";
+import { copilotHome } from "./agents.js";
 function ours(cmd) {
-    return !!cmd?.includes(HOOK_MARKER);
+    return isOurHookCommand(cmd);
 }
 function readJson(file) {
     if (!existsSync(file))
@@ -189,4 +190,61 @@ export function removeCursorHooks(projectDir = process.cwd()) {
     }
     return out;
 }
+export function copilotHooksPath(scope, projectDir = process.cwd()) {
+    return scope === "user"
+        ? join(copilotHome(), "hooks", "pantheon.json")
+        : join(projectDir, ".github", "hooks", "pantheon.json");
+}
+function copilotEvents(bin) {
+    return {
+        agentStop: `${bin} hook copilot-stop`,
+        userPromptSubmitted: `${bin} hook prompt`,
+        sessionEnd: `${bin} hook end`,
+    };
+}
+export function copilotHookState(scope, projectDir = process.cwd()) {
+    const file = copilotHooksPath(scope, projectDir);
+    const doc = readJson(file);
+    if (!doc?.hooks)
+        return { agent: "copilot", label: "Copilot", installed: false };
+    const events = [];
+    for (const [event, entries] of Object.entries(doc.hooks)) {
+        if ((entries ?? []).some((h) => ours(h.command) || ours(h.bash)))
+            events.push(event);
+    }
+    return events.length
+        ? { agent: "copilot", label: "Copilot", installed: true, scope, file, events }
+        : { agent: "copilot", label: "Copilot", installed: false };
+}
+export function installCopilotHooks(bin, scope, projectDir = process.cwd()) {
+    const file = copilotHooksPath(scope, projectDir);
+    const existed = existsSync(file);
+    const events = copilotEvents(bin);
+    const doc = { version: 1, hooks: {} };
+    for (const [event, cmd] of Object.entries(events)) {
+        doc.hooks[event] = [{ type: "command", command: cmd, timeoutSec: 10, timeout: 10 }];
+    }
+    writeJson(file, doc);
+    return [
+        `  ${existed ? "updated" : "installed"}  ${file}`,
+        `  runs       ${events.agentStop}`,
+        `             ${events.userPromptSubmitted}`,
+        `             ${events.sessionEnd}`,
+        `  ${""}(read by Copilot CLI and by Copilot in VS Code${scope === "project" ? "; repo-level hooks run once the folder is trusted" : ""})`,
+    ];
+}
+export function removeCopilotHooks(projectDir = process.cwd()) {
+    const out = [];
+    for (const scope of ["project", "user"]) {
+        const file = copilotHooksPath(scope, projectDir);
+        if (!copilotHookState(scope, projectDir).installed)
+            continue;
+        try {
+            rmSync(file, { force: true });
+            out.push(`  removed ${file}`);
+        }
+        catch { }
+    }
+    return out;
+}
 //# sourceMappingURL=hooks-install.js.map

package/dist/install.js

@@ -1,48 +1,71 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { execFileSync } from "node:child_process";
-import { homedir } from "node:os";
+import { homedir, platform } from "node:os";
 import { join, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { grantToolPermissions, claudeSettingsFile, cursorCliConfigFile } from "./grants.js";
 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";
 const HERE = dirname(fileURLToPath(import.meta.url));
 export function onPath() {
-    try {
-        execFileSync("sh", ["-lc", "command -v pantheon"], { stdio: ["ignore", "ignore", "ignore"] });
-        return true;
-    }
-    catch {
-        return false;
-    }
+    return onPathNamed("pantheon");
 }
-export function launcher(force) {
+export function launcher(force, os = platform()) {
     const portable = force === "portable" || (force !== "local" && onPath());
+    if (os === "win32")
+        return { command: process.execPath, args: [resolve(HERE, "cli.js"), "mcp"], portable: false };
     return portable
         ? { command: "pantheon", args: ["mcp"], portable: true }
         : { command: process.execPath, args: [resolve(HERE, "cli.js"), "mcp"], portable: false };
 }
-function mergeMcpJson(file, entry) {
-    let doc = {};
-    if (existsSync(file)) {
-        try {
-            doc = JSON.parse(readFileSync(file, "utf8"));
-        }
-        catch {
-            throw new Error(`${file} is not valid JSON — fix or move it, then re-run`);
-        }
+function readConfigJson(file) {
+    if (!existsSync(file))
+        return {};
+    const text = readFileSync(file, "utf8");
+    if (!text.trim())
+        return {};
+    try {
+        const doc = JSON.parse(text);
+        if (doc && typeof doc === "object" && !Array.isArray(doc))
+            return doc;
     }
+    catch { }
+    throw new Error(`${file} is not valid JSON — fix or move it, then re-run`);
+}
+function mergeMcpJson(file, entry, shape = {}) {
+    const doc = readConfigJson(file);
     const existed = existsSync(file);
     doc.mcpServers ??= {};
     const before = JSON.stringify(doc.mcpServers["pantheon"] ?? null);
-    doc.mcpServers["pantheon"] = { ...entry, env: {} };
+    doc.mcpServers["pantheon"] = { ...shape, ...entry, env: {} };
     if (before === JSON.stringify(doc.mcpServers["pantheon"]))
         return "unchanged";
     mkdirSync(dirname(file), { recursive: true });
     writeFileSync(file, JSON.stringify(doc, null, 2) + "\n");
     return existed ? "updated" : "created";
 }
+export const COPILOT_ENTRY_SHAPE = { type: "local", tools: ["*"] };
+export function mergeVsCodeMcpJson(file, entry) {
+    const doc = readConfigJson(file);
+    const existed = existsSync(file);
+    doc.servers ??= {};
+    const before = JSON.stringify(doc.servers["pantheon"] ?? null);
+    doc.servers["pantheon"] = { type: "stdio", command: entry.command, args: entry.args };
+    if (before === JSON.stringify(doc.servers["pantheon"]))
+        return "unchanged";
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, JSON.stringify(doc, null, 2) + "\n");
+    return existed ? "updated" : "created";
+}
+export const copilotMcpConfigFile = (home = homedir(), env = process.env) => join(env.COPILOT_HOME || join(home, ".copilot"), "mcp-config.json");
+export function vsCodeUserDir(home = homedir(), os = platform(), env = process.env) {
+    const dir = os === "darwin" ? join(home, "Library", "Application Support", "Code", "User")
+        : os === "win32" ? join(env.APPDATA || join(home, "AppData", "Roaming"), "Code", "User")
+            : join(env.XDG_CONFIG_HOME || join(home, ".config"), "Code", "User");
+    return existsSync(dir) ? dir : null;
+}
 const BRIEF_MARK = "<!-- pantheon:begin -->";
 function brief(cfg) {
     return `${BRIEF_MARK}
@@ -95,14 +118,19 @@ export function install(projectDir, cfg, force) {
     const out = [];
     const l = launcher(force);
     const entry = { command: l.command, args: l.args };
-    out.push(`  .mcp.json                 ${mergeMcpJson(join(projectDir, ".mcp.json"), entry)}   (claude code, conductor)`);
+    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");
+    out.push(existsSync(vscodeDir) || vsCodeUserDir()
+        ? `  .vscode/mcp.json          ${mergeVsCodeMcpJson(join(vscodeDir, "mcp.json"), entry)}   (copilot in vs code)`
+        : `  .vscode/mcp.json          ${"skipped".padEnd(9)} no .vscode/ here and no VS Code on this machine   (a VS Code user runs pantheon install --user)`);
     for (const f of ["CLAUDE.md", "AGENTS.md"]) {
         const p = join(projectDir, f);
         if (existsSync(p) || f === "AGENTS.md")
             out.push(`  ${f.padEnd(25)} ${upsertBrief(p, cfg)}   (the collaboration brief)`);
     }
     out.push("");
+    out.push("  Copilot asks once to trust this folder before it reads the repo's MCP servers and hooks.");
     out.push("  Codex reads ~/.codex/config.toml, which `pantheon join` already wrote at user scope.");
     out.push("  If you need it by hand, this is the block (absolute path so a GUI launch finds it):");
     out.push("");
@@ -128,9 +156,17 @@ export function install(projectDir, cfg, force) {
 function localEntry() {
     return { command: process.execPath, args: [resolve(HERE, "cli.js"), "mcp"] };
 }
-function userEntry() {
+function userEntry(os = platform()) {
+    if (os === "win32") {
+        const node = process.execPath;
+        const entry = resolve(HERE, "cli.js");
+        if (existsSync(entry))
+            return { command: node, args: [entry, "mcp"] };
+        const abs = which("pantheon");
+        return abs ? { command: abs, args: ["mcp"] } : { command: "pantheon", args: ["mcp"] };
+    }
     try {
-        const abs = execFileSync("sh", ["-lc", "command -v pantheon"], { encoding: "utf8" }).trim();
+        const abs = which("pantheon") ?? "";
         if (abs && !isVersionManagedPath(abs))
             return { command: abs, args: ["mcp"] };
         if (abs)
@@ -145,18 +181,17 @@ function isVersionManagedPath(p) {
 }
 function claudeUserScope(entry) {
     const tool = "claude code";
-    try {
-        execFileSync("sh", ["-lc", "command -v claude"], { stdio: "ignore" });
-    }
-    catch {
+    const claudeBin = which("claude");
+    if (!claudeBin)
         return { tool, where: "-", status: "skipped (claude not on PATH)" };
-    }
     try {
+        const remove = agentSpawn(claudeBin, ["mcp", "remove", "pantheon", "-s", "user"]);
+        const add = agentSpawn(claudeBin, ["mcp", "add", "pantheon", "-s", "user", "--", entry.command, ...entry.args]);
         try {
-            execFileSync("claude", ["mcp", "remove", "pantheon", "-s", "user"], { stdio: "ignore" });
+            execFileSync(remove.command, remove.args, { stdio: "ignore", ...remove.options });
         }
         catch { }
-        execFileSync("claude", ["mcp", "add", "pantheon", "-s", "user", "--", entry.command, ...entry.args], { stdio: "ignore" });
+        execFileSync(add.command, add.args, { stdio: "ignore", ...add.options });
         return { tool, where: "user scope", status: "ready in every project and every Conductor window" };
     }
     catch (e) {
@@ -172,11 +207,39 @@ function cursorUserScope(entry) {
         return { tool: "cursor", where: file, status: `failed: ${e.message}` };
     }
 }
+function copilotUserScope(entry) {
+    const tool = "copilot";
+    const file = copilotMcpConfigFile();
+    let present = existsSync(dirname(file));
+    if (!present && onPathNamed("copilot"))
+        present = true;
+    if (!present)
+        return { tool, where: "-", status: "skipped (copilot not on PATH)" };
+    try {
+        return { tool, where: file, status: mergeMcpJson(file, entry, COPILOT_ENTRY_SHAPE) };
+    }
+    catch (e) {
+        return { tool, where: file, status: `failed: ${e.message}` };
+    }
+}
+function vsCodeUserScope(entry) {
+    const tool = "vs code";
+    const dir = vsCodeUserDir();
+    if (!dir)
+        return { tool, where: "-", status: "skipped (VS Code not found)" };
+    const file = join(dir, "mcp.json");
+    try {
+        return { tool, where: file, status: mergeVsCodeMcpJson(file, entry) };
+    }
+    catch (e) {
+        return { tool, where: file, status: `failed: ${e.message}` };
+    }
+}
 export const CODEX_APPROVAL_LINE = `default_tools_approval_mode = "approve"`;
 export function approvalSummary(approval) {
     return approval === "ask-before-sending"
         ? `your agent asks you before each send, goal or claim in your name; reading and waiting run without a prompt. Unattended runs keep their own per-run approvals — this governs the agent you sit in front of`
-        : `pantheon's ${PANTHEON_TOOL_NAMES.length} tools run without a per-call prompt in Claude Code, Cursor and Codex — your agent coordinates for you without stopping to ask`;
+        : `pantheon's ${PANTHEON_TOOL_NAMES.length} tools run without a per-call prompt in Claude Code, Cursor and Codex — your agent coordinates for you without stopping to ask. Copilot has no allow-list file: it asks once per tool per folder and remembers your answer`;
 }
 export function codexTomlBlock(entry, env = { PANTHEON_AGENT: "codex" }, approval = "approve") {
     const envToml = Object.entries(env)
@@ -374,6 +437,7 @@ export function installForUser(approval = chosenApproval()) {
     const entry = userEntry();
     return [
         claudeUserScope(entry), cursorUserScope(entry), codexUserScope(entry, approval),
+        copilotUserScope(entry), vsCodeUserScope(entry),
         ...grantToolPermissions(approval).map((g) => ({
             tool: g.tool,
             where: g.tool.startsWith("claude") ? claudeSettingsFile() : cursorCliConfigFile(),

package/dist/machine.js

@@ -4,6 +4,7 @@ import { homedir, platform } from "node:os";
 import { join } from "node:path";
 import { CONFIG_DIR } from "./config.js";
 import { plistPath } from "./service.js";
+import { copilotMcpConfigFile, vsCodeUserDir } from "./install.js";
 const sh = (cmd) => {
     try {
         return execFileSync("sh", ["-lc", cmd], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim() || null;
@@ -109,6 +110,16 @@ export function wiring() {
         tool: "codex",
         state: existsSync(codex) && /\[mcp_servers\.pantheon\]/.test(readFileSync(codex, "utf8")) ? "wired" : "not wired",
     });
+    const copilot = copilotMcpConfigFile();
+    out.push({
+        tool: "copilot",
+        state: existsSync(copilot) && /"pantheon"/.test(readFileSync(copilot, "utf8")) ? "wired" : "not wired",
+    });
+    const vscodeDir = vsCodeUserDir();
+    if (vscodeDir) {
+        const f = join(vscodeDir, "mcp.json");
+        out.push({ tool: "vs code", state: existsSync(f) && /"pantheon"/.test(readFileSync(f, "utf8")) ? "wired" : "not wired" });
+    }
     return out;
 }
 export function logFileFor(kind, proc) {

package/dist/measure.js

@@ -3,7 +3,9 @@ import { existsSync } from "node:fs";
 import { resolve, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { claudeGrantedEffective, cursorGrantedEffective, claudeAllow, cursorAllow, isServerWide } from "./grants.js";
-import { codexApprovalState } from "./install.js";
+import { codexApprovalState, copilotMcpConfigFile } from "./install.js";
+import { existsSync as fileExists, readFileSync } from "node:fs";
+import { dirname as dirOf } from "node:path";
 import { PANTHEON_TOOL_NAMES, WRITE_TOOL_NAMES } from "./tools.js";
 const ROOT = process.env.PANTHEON_MCP_ROOT ?? resolve(dirname(fileURLToPath(import.meta.url)), "..");
 export const HOST_STARTUP_ALLOWANCE_MS = 10_000;
@@ -157,12 +159,24 @@ export function toolsReport(registered, seen, approval, opts = {}) {
             problems.push("Codex's per-tool overrides do not match your choice");
         }
     }
-    const detail = `${head}; ${claude.text}, ${cursor.text}, ${codex}`;
+    const copilot = seen.copilot === undefined || seen.copilot === null ? null
+        : seen.copilot ? "Copilot wired (it asks once per tool per folder and remembers)" : "Copilot has no pantheon entry";
+    const detail = `${head}; ${claude.text}, ${cursor.text}, ${codex}${copilot ? `, ${copilot}` : ""}`;
     if (!problems.length)
         return { level: "pass", detail };
     return { level: "warn", detail, fix: `${problems.join("; ")} — pantheon install --user rewrites every grant in your own settings to match this build and your approval choice; a rule in this repo's .claude/settings*.json or .cursor/cli.json is yours to edit by hand` };
 }
 export function grantsSeen(projectDir = null) {
-    return { claude: claudeGrantedEffective(projectDir), cursor: cursorGrantedEffective(projectDir), codex: codexApprovalState() };
+    return { claude: claudeGrantedEffective(projectDir), cursor: cursorGrantedEffective(projectDir), codex: codexApprovalState(), copilot: copilotWired() };
+}
+export function copilotWired(file = copilotMcpConfigFile()) {
+    if (!fileExists(dirOf(file)))
+        return null;
+    try {
+        return fileExists(file) && /"pantheon"/.test(readFileSync(file, "utf8"));
+    }
+    catch {
+        return false;
+    }
 }
 //# sourceMappingURL=measure.js.map

package/dist/notice.js

@@ -1,10 +1,11 @@
 import { decisionPrompt, decisionTitle } from "./decision-ui.js";
-export const TOOL_LABELS = { "claude-code": "Claude Code", codex: "Codex", cursor: "Cursor", grok: "Grok" };
+export const TOOL_LABELS = { "claude-code": "Claude Code", codex: "Codex", cursor: "Cursor", copilot: "Copilot", grok: "Grok" };
 export const APP_TOOLS = [
     { id: "cursor-app", label: "Cursor app", kind: "app", bundle: "com.todesktop.230313mzl4w4u92", deeplink: "cursor://anysphere.cursor-deeplink/prompt?text={prompt}" },
     { id: "claude-app", label: "Claude app · question copied", kind: "app", bundle: "com.anthropic.claudefordesktop" },
     { id: "chatgpt-app", label: "ChatGPT app · question copied", kind: "app", bundle: "com.openai.chat" },
     { id: "codex-app", label: "Codex app · question copied", kind: "app", bundle: "com.openai.codex" },
+    { id: "vscode-app", label: "VS Code · question copied", kind: "app", bundle: "com.microsoft.VSCode" },
 ];
 export const BUDGET = { who: 60, heading: 40, context: 70, body: 190 };
 const oneLine = (s) => s.replace(/\s+/g, " ").trim();
@@ -64,6 +65,8 @@ const agentLabel = (agent) => {
         return "Codex";
     if (a.includes("cursor"))
         return "Cursor";
+    if (a.includes("copilot"))
+        return "Copilot";
     return null;
 };
 function whoLine(from, agent, ts, now) {

package/dist/notifier.js

@@ -99,6 +99,7 @@ export function installedTools() {
             "claude-app": ["/Applications/Claude.app", join(homedir(), "Applications", "Claude.app")],
             "chatgpt-app": ["/Applications/ChatGPT.app", join(homedir(), "Applications", "ChatGPT.app")],
             "codex-app": ["/Applications/Codex.app", join(homedir(), "Applications", "Codex.app")],
+            "vscode-app": ["/Applications/Visual Studio Code.app", join(homedir(), "Applications", "Visual Studio Code.app")],
         };
         for (const t of APP_TOOLS)
             if ((APP_PATHS[t.id] ?? []).some((p) => existsSync(p)))

package/dist/notify.js

@@ -3,8 +3,11 @@ import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { whichPantheon } from "./service.js";
 import { detectForHooks, agentById } from "./agents.js";
-import { codexHookState, cursorHookState, installCodexHooks, installCursorHooks, removeCodexHooks, removeCursorHooks, } from "./hooks-install.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 isOurHookCommand = (cmd) => !!cmd && (cmd.includes(HOOK_MARKER) || HOOK_RE.test(cmd));
+export const hookBin = (bin) => (/\s/.test(bin) ? `"${bin}"` : bin);
 export function settingsPath(scope, projectDir = process.cwd()) {
     return scope === "user"
         ? join(homedir(), ".claude", "settings.json")
@@ -25,7 +28,7 @@ function write(file, doc) {
     writeFileSync(file, JSON.stringify(doc, null, 2) + "\n");
 }
 function ours(g) {
-    return g.hooks?.some((h) => h.command?.includes(HOOK_MARKER)) ?? false;
+    return g.hooks?.some((h) => isOurHookCommand(h.command)) ?? false;
 }
 export function hookState(projectDir = process.cwd(), only) {
     for (const scope of (only ? [only] : ["project", "user"])) {
@@ -46,7 +49,7 @@ export function hookState(projectDir = process.cwd(), only) {
             if (!hit)
                 continue;
             events.push(event);
-            command ??= hit.hooks.find((h) => h.command.includes(HOOK_MARKER)).command;
+            command ??= hit.hooks.find((h) => isOurHookCommand(h.command)).command;
         }
         if (events.length)
             return { installed: true, scope, file, command, events };
@@ -93,6 +96,9 @@ export function agentHookStates(projectDir = process.cwd(), only) {
         const cursor = cursorHookState(scope, projectDir);
         if (cursor.installed)
             out.push(cursor);
+        const copilot = copilotHookState(scope, projectDir);
+        if (copilot.installed)
+            out.push(copilot);
     }
     const byAgent = new Map();
     for (const s of out) {
@@ -116,6 +122,8 @@ export function repairHook(home) {
             missing.push(id);
         if (id === "cursor" && !cursorHookState(intent.scope, projectDir).installed)
             missing.push(id);
+        if (id === "copilot" && !copilotHookState(intent.scope, projectDir).installed)
+            missing.push(id);
     }
     if (!missing.length)
         return null;
@@ -132,7 +140,10 @@ export function repairHook(home) {
 function installClaudeHook(scope, projectDir = process.cwd()) {
     const file = settingsPath(scope, projectDir);
     const doc = read(file);
-    const bin = whichPantheon();
+    const found = whichPantheon();
+    if (!found)
+        throw new Error("pantheon binary not found on PATH");
+    const bin = hookBin(found);
     const events = {
         Stop: `${bin} hook stop`,
         UserPromptSubmit: `${bin} hook prompt`,
@@ -165,7 +176,7 @@ export function installHooks(scope, projectDir = process.cwd(), only) {
         ? only.map((id) => agentById(id)).filter((b) => !!b)
         : available;
     if (!pick.length) {
-        throw new Error("no agent found — install claude, codex, or cursor-agent, or open a project that already uses one");
+        throw new Error("no agent found — install claude, codex, cursor-agent, or copilot, or open a project that already uses one");
     }
     const lines = [];
     const agents = [];
@@ -183,6 +194,10 @@ export function installHooks(scope, projectDir = process.cwd(), only) {
             lines.push(...installCursorHooks(bin, scope, projectDir));
             agents.push("cursor");
         }
+        else if (backend.id === "copilot") {
+            lines.push(...installCopilotHooks(bin, scope, projectDir));
+            agents.push("copilot");
+        }
     }
     lines.push(`  effect     when your agent tries to finish, it checks whether a peer is waiting`, `             on you — and keeps going instead of leaving them hanging.`, `             it also reports when a turn starts and ends, so a worker can tell`, `             an idle editor from one you are actually using.`);
     return { lines, agents };
@@ -195,6 +210,7 @@ export function removeHook(projectDir = process.cwd()) {
     out.push(...removeClaudeHook(projectDir));
     out.push(...removeCodexHooks(projectDir));
     out.push(...removeCursorHooks(projectDir));
+    out.push(...removeCopilotHooks(projectDir));
     return out.length ? out : ["  nothing installed"];
 }
 function removeClaudeHook(projectDir = process.cwd()) {

package/dist/persona.js

@@ -170,7 +170,7 @@ export const PERSONA_TEMPLATE = `---
 # wake_by: alice, bob          # only these peers' requests are handled by this persona
 # kinds: ANSWER, ACCEPT        # ANSWER (asks), ACCEPT (verdicts), REVISE (objections), CONTINUE (replies/deliveries)
 # goals: launch-*              # only goals whose id or title matches
-# agent: auto                  # claude-code | codex | cursor | auto
+# agent: auto                  # claude-code | codex | cursor | copilot | auto
 ---
 Say how this worker should behave when it is woken while you are away — what it
 should take on, what it should refuse, and where its judgment ends and yours

package/dist/profile.js

@@ -1,11 +1,12 @@
 import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { CONFIG_DIR } from "./config.js";
-export const AGENT_SURFACES = ["codex", "claude-code", "cursor"];
+export const AGENT_SURFACES = ["codex", "claude-code", "cursor", "copilot"];
 export const SURFACE_BUNDLE_IDS = {
     codex: "com.openai.codex",
     "claude-code": "com.anthropic.claudefordesktop",
     cursor: "com.todesktop.230313mzl4w4u92",
+    copilot: "com.microsoft.VSCode",
 };
 export const profilePath = (home = CONFIG_DIR) => join(home, "profile.json");
 export function isAgentSurface(value) {
@@ -14,6 +15,8 @@ export function isAgentSurface(value) {
 export function surfaceFromAgent(agent) {
     if (agent && /cursor/i.test(agent))
         return "cursor";
+    if (agent && /copilot/i.test(agent))
+        return "copilot";
     if (agent && /claude/i.test(agent))
         return "claude-code";
     return "codex";

package/dist/quickstart.js

@@ -16,6 +16,7 @@ import { desktopUnavailable, ephemeralWarning, hostEnv } from "./host-env.js";
 import { existsSync } from "node:fs";
 import { grant as grantCap, loadPolicy, policyPath, savePolicy } from "./worker-policy.js";
 import { Relay } from "./relay.js";
+import { which } from "./which.js";
 const sh = (cmd) => {
     try {
         return execFileSync("sh", ["-lc", cmd], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim() || null;
@@ -126,7 +127,7 @@ export function findReach(port) {
     if (ts && /^\d+\.\d+\.\d+\.\d+$/.test(ts)) {
         return { url: `ws://${ts}:${port}`, how: `tailscale (${ts})`, shareable: true };
     }
-    if (sh("command -v cloudflared")) {
+    if (which("cloudflared")) {
         return {
             url: `ws://127.0.0.1:${port}`, how: "localhost", shareable: false,
             hint: `cloudflared is installed. To let a teammate reach you:\n` +

package/dist/run-failure.js

@@ -1,4 +1,11 @@
 import { execFileSync } from "node:child_process";
+export const AUTH_RE = /not (?:logged|signed) in|not authenticated|no (?:github )?(?:authentication|credentials?|token) (?:found|available)|login required|please (?:log|sign) in|run .*login|invalid api key|unauthori[sz]ed|authentication (?:failed|required)|\b401\b|expired (?:token|session)/i;
+export const SIGN_IN_FIX = {
+    "claude-code": "run `claude`, then /login",
+    codex: "run `codex login`",
+    cursor: "run `cursor-agent login`",
+    copilot: "run `copilot login` (or `gh auth login` — copilot uses gh's sign-in too)",
+};
 const sh = (dir, ...args) => execFileSync("git", ["-C", dir, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 5_000 }).trim();
 export const gitProbe = {
     isRepo: (dir) => { try {
@@ -42,6 +49,14 @@ catch {
     return fallback;
 } };
 export function diagnoseRun(f, probe = gitProbe) {
+    if (!f.exited && AUTH_RE.test(f.detail)) {
+        const fix = SIGN_IN_FIX[f.agent ?? ""] ?? "sign in to the agent CLI on this machine";
+        return {
+            cause: "not_signed_in",
+            says: `The agent could not start because nobody is signed in to it${f.agent ? ` (${f.agent})` : ""} — ${exitLine(f.detail)}.`,
+            fix: `Sign in once and the next run works: ${fix}. Until then every woken run on this machine fails the same way.`,
+        };
+    }
     if (!f.exited) {
         return {
             cause: "crashed",

package/dist/service.js

@@ -1,6 +1,7 @@
 import { writeFileSync, mkdirSync, existsSync, unlinkSync } from "node:fs";
 import { execFileSync } from "node:child_process";
 import { homedir, platform } from "node:os";
+import { which } from "./which.js";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { launcher } from "./install.js";
@@ -29,6 +30,8 @@ function argvFor(kind, args) {
     return abs ? [abs, kind, ...args] : [process.execPath, resolve(HERE, "cli.js"), kind, ...args];
 }
 export function whichPantheon() {
+    if (platform() === "win32")
+        return which("pantheon");
     try {
         const p = execFileSync("/usr/bin/which", ["pantheon"], { encoding: "utf8" }).trim();
         return p.startsWith("/") && existsSync(p) ? p : null;

package/dist/setup-guide.js

@@ -195,7 +195,7 @@ export async function runGuide(io, ctx, deps = {}, preset = {}) {
                     : "only people you approve by hand (pantheon admit <name> --may-wake)"}`);
         io.say(`  • Alerts: ${shortAlert(a.notifications).toLowerCase()}`);
         io.say(`  • Approval: ${a.approval === "approve"
-            ? "your agent sends to teammates in your name without asking each time (Claude Code, Cursor and Codex)"
+            ? "your agent sends to teammates in your name without asking each time (Claude Code, Cursor and Codex; Copilot asks once per tool per folder)"
             : "your agent asks you before each send, goal and claim; reading and waiting never prompt"}`);
         io.say(`  • Decisions: ${a.decides.length ? `you personally decide ${a.decides.join(", ")}` : "none reserved for you — your agent may decide; add an area when one comes up"}`);
         if (a.wake !== "no" && ctx.project)

package/dist/tray.js

@@ -144,7 +144,7 @@ async function trayStatusOne(cfg) {
     ];
     const profile = loadProfile(cfg);
     const surface = profile.agent.primary_surface;
-    const surfaceName = surface === "claude-code" ? "Claude" : surface === "cursor" ? "Cursor" : "Codex";
+    const surfaceName = surface === "claude-code" ? "Claude" : surface === "cursor" ? "Cursor" : surface === "copilot" ? "Copilot" : "Codex";
     const rawWorkerState = workerState();
     return {
         configured: true,

package/dist/update-check.js

@@ -43,6 +43,8 @@ export function updateStatus(deps) {
 export function versionLine(version, behind, latest) {
     if (behind <= 0)
         return `pantheon ${version}`;
+    if (latest && !semverGt(latest, version))
+        return `pantheon ${version}`;
     return latest
         ? `pantheon ${version}  ·  ${latest} available — run \`pantheon upgrade\``
         : `pantheon ${version}  ·  ${behind} update${behind === 1 ? "" : "s"} behind — run \`pantheon upgrade\``;