create-egregore 0.19.5 → 0.19.7

package/bin/cli.js

@@ -4,7 +4,7 @@
  * create-egregore — set up Egregore for your team in one command.
  *
  *   - Installs an `egregore` PATH binary instead of a shell alias
- *   - Auto-execs into the selected assistant (Claude Code or Codex) at the end
+ *   - Auto-execs into the selected harness (Claude Code, Codex, or Pi) at the end
  *
  * Four modes:
  *   npx -y create-egregore@latest --token st_xxxx    (from website)
@@ -30,6 +30,11 @@ const {
   installCodexRuntime,
   reportCodexRuntimeSummary,
 } = require("../lib/codex-runtime");
+const {
+  hasPiRuntimeSupport,
+  installPiRuntime,
+  reportPiRuntimeSummary,
+} = require("../lib/pi-runtime");
 const {
   install,
   ghApi,
@@ -96,10 +101,13 @@ function binaryOnPath(bin) {
 }
 
 function assistantLabel(runtime) {
-  return normalizeRuntime(runtime) === "codex" ? "Codex" : "Claude Code";
+  const normalized = normalizeRuntime(runtime);
+  if (normalized === "codex") return "Codex";
+  if (normalized === "pi") return "Pi";
+  return "Claude Code";
 }
 
-function upgradeCodexRuntimeForExisting(instances) {
+function upgradePortableRuntimesForExisting(instances) {
   for (const inst of instances) {
     if (!inst || !inst.path || !fs.existsSync(inst.path)) continue;
     try {
@@ -109,8 +117,14 @@ function upgradeCodexRuntimeForExisting(instances) {
         label: `Codex runtime for ${inst.slug || inst.name || path.basename(inst.path)}`,
         includeConflicts: !ready,
       });
+      const piSummary = installPiRuntime(inst.path);
+      const piReady = hasPiRuntimeSupport(inst.path);
+      reportPiRuntimeSummary(piSummary, ui, {
+        label: `Pi meta-harness for ${inst.slug || inst.name || path.basename(inst.path)}`,
+        includeConflicts: !piReady,
+      });
     } catch (err) {
-      ui.warn(`Could not install Codex runtime for ${inst.path}: ${err.message}`);
+      ui.warn(`Could not refresh shell-runtime support for ${inst.path}: ${err.message}`);
     }
   }
 }
@@ -127,37 +141,34 @@ async function chooseRuntime(args) {
 
   if (!process.stdin.isTTY) return "claude-code";
 
-  const hasClaude = binaryOnPath("claude");
-  const hasCodex = binaryOnPath("codex");
-  const recommended = !hasClaude && hasCodex ? "codex" : "claude-code";
-  const choices = ["claude-code", "codex"]
+  const installedByRuntime = {
+    "claude-code": binaryOnPath("claude"),
+    codex: binaryOnPath("codex"),
+    pi: binaryOnPath("pi"),
+  };
+  const recommended = Object.keys(installedByRuntime).find((runtime) => installedByRuntime[runtime]) || "claude-code";
+  const choices = ["claude-code", "codex", "pi"]
     .map((runtime) => {
-      const installed = runtime === "codex" ? hasCodex : hasClaude;
+      const installed = installedByRuntime[runtime];
       const label = assistantLabel(runtime);
-      const missingCopy = runtime === "codex"
-        ? "Install Codex later, then run egregore and choose Codex"
-        : "Install Claude Code later, then run egregore and choose Claude Code";
+      const missingCopy = `Install ${label} later, then run egregore and choose ${label}`;
       return {
         label: `${label}${installed ? "" : " (not installed)"}${recommended === runtime ? " (recommended)" : ""}`,
         description: installed
-          ? (runtime === "codex" ? "Installed · portable agent protocol" : "Installed · Claude Code integration")
+          ? (runtime === "claude-code" ? "Installed · Claude Code integration" : runtime === "pi" ? "Installed · project-local meta-harness" : "Installed · portable agent protocol")
           : missingCopy,
         runtime,
         installed,
       };
     })
     .sort((a, b) => Number(b.installed) - Number(a.installed));
-  // Coming-soon harnesses — shown for visibility, not yet selectable.
-  choices.push(
-    { label: "Hermes", description: "coming soon", runtime: "hermes", disabled: true },
-    { label: "Pi", description: "coming soon", runtime: "pi", disabled: true },
-  );
+  choices.push({ label: "Hermes", description: "coming soon", runtime: "hermes", disabled: true });
   const choice = await ui.choose("Which harness do you want to use?", choices);
   return choice.runtime;
 }
 
 async function upgradeLauncherFromExisting(instances) {
-  upgradeCodexRuntimeForExisting(instances);
+  upgradePortableRuntimesForExisting(instances);
   const inst = instances.find((entry) => entry && entry.path && fs.existsSync(entry.path));
   if (!inst) return null;
   try {
@@ -214,6 +225,8 @@ function parseArgs(argv) {
       args.noWelcome = true;
     } else if (argv[i] === "--codex") {
       args.runtime = "codex";
+    } else if (argv[i] === "--pi") {
+      args.runtime = "pi";
     } else if (argv[i] === "--claude" || argv[i] === "--claude-code") {
       args.runtime = "claude-code";
     } else if (argv[i] === "--runtime" && argv[i + 1]) {
@@ -376,8 +389,9 @@ function showHelp() {
   ui.info("  --token <token>   Setup token from egregore.xyz");
   ui.info("  --api <url>       Use connected API setup with this URL");
   ui.info("  --codex           Prefer Codex for this local install");
+  ui.info("  --pi              Prefer Pi for this local install");
   ui.info("  --claude          Prefer Claude Code for this local install");
-  ui.info("  --runtime <name>  Harness override: claude-code or codex");
+  ui.info("  --runtime <name>  Harness override: claude-code, codex, or pi");
   ui.info("  --force           Skip the in-repo detection check");
   ui.info("  --no-autolaunch   Don't launch the harness at the end (for CI)");
   ui.info("  --no-screens      Skip the full-screen welcome/ready bookends");

package/lib/local.js

@@ -16,6 +16,7 @@ const {
   tryGhAuthOrLogin,
 } = require("./auth");
 const { installCodexRuntime, reportCodexRuntimeSummary } = require("./codex-runtime");
+const { installPiRuntime, reportPiRuntimeSummary } = require("./pi-runtime");
 const {
   install,
   ghApi,
@@ -625,13 +626,13 @@ async function maybeSetupTelegramGroup(ui, {
   return { setup: true, groupLink: storedGroupLink };
 }
 
-// Claude Code workspace cleanup: remove the Codex AGENTS.md/.codex/.agents the
+// Claude Code workspace cleanup: remove shell-runtime overlays the
 // GitHub template ships, so the agent follows CLAUDE.md rather than a competing
 // startup protocol. Founder-only (we own the repo) — commit + push the removal
 // so it persists for everyone who clones it. A Codex teammate who joins later
 // regenerates AGENTS.md via /update (bin/codex-render-spec.mjs).
 function stripCodexRuntimeForClaude(egregoreDir, ui) {
-  const targets = ["AGENTS.md", ".codex", ".agents"];
+  const targets = ["AGENTS.md", ".codex", ".agents", ".pi"];
   const present = targets.filter((t) => fs.existsSync(path.join(egregoreDir, t)));
   if (!present.length) {
     ui.success("Claude Code workspace — using CLAUDE.md");
@@ -639,7 +640,7 @@ function stripCodexRuntimeForClaude(egregoreDir, ui) {
   }
   try {
     execFileSync("git", ["rm", "-r", "-q", "--", ...present], { cwd: egregoreDir, stdio: "pipe" });
-    run('git commit -m "Claude Code workspace: use CLAUDE.md, drop Codex AGENTS.md/.codex"', { cwd: egregoreDir });
+    run('git commit -m "Claude Code workspace: use CLAUDE.md, drop shell-runtime overlays"', { cwd: egregoreDir });
     run("git push", { cwd: egregoreDir });
     ui.success(`Claude Code workspace — using CLAUDE.md (removed ${present.join(", ")})`);
   } catch {
@@ -1355,7 +1356,7 @@ async function localFounderFlow(ui, ctx = {}) {
     }
   }
 
-  // 16. Runtime overlay. Codex installs commit the Codex runtime into the repo
+  // 16. Runtime overlay. Codex and Pi installs commit their derived runtime
   //     so it's TRACKED (symmetric with .claude/). Claude installs do the
   //     opposite: Claude Code reads CLAUDE.md, not AGENTS.md, so we strip the
   //     Codex AGENTS.md/.codex the template ships — otherwise a fresh Claude
@@ -1378,6 +1379,17 @@ async function localFounderFlow(ui, ctx = {}) {
         run("git push", { cwd: egregoreDir });
       }
     } catch {}
+  } else if (preferredRuntime === "pi") {
+    const piRuntime = installPiRuntime(egregoreDir);
+    reportPiRuntimeSummary(piRuntime, ui);
+    try {
+      const toCommit = Array.isArray(piRuntime.files) ? [...piRuntime.files] : [];
+      if (toCommit.length) {
+        execFileSync("git", ["add", "--", ...toCommit], { cwd: egregoreDir, stdio: "pipe" });
+        run('git commit -m "Add Pi meta-harness runtime"', { cwd: egregoreDir });
+        run("git push", { cwd: egregoreDir });
+      }
+    } catch {}
   } else {
     stripCodexRuntimeForClaude(egregoreDir, ui);
   }
@@ -1545,7 +1557,11 @@ async function localFounderFlow(ui, ctx = {}) {
       return { label: `./${mrName}/`, description: "managed repo" };
     }),
   ];
-  const assistantName = preferredRuntime === "codex" ? "Codex" : "Claude Code";
+  const assistantName = preferredRuntime === "codex"
+    ? "Codex"
+    : preferredRuntime === "pi"
+      ? "Pi"
+      : "Claude Code";
   const setupSummary = {
     workspace: "created",
     invite: invitedUsers.length

package/lib/pi-runtime.js

@@ -0,0 +1,186 @@
+"use strict";
+
+const crypto = require("node:crypto");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const PACKAGE = require("../package.json");
+
+const BUNDLE_DIR = path.join(__dirname, "..", "runtime", "pi");
+const BUNDLE_MANIFEST = path.join(BUNDLE_DIR, "manifest.json");
+const LOCAL_MANIFEST = path.join(".egregore", "pi-runtime-manifest.json");
+
+const REQUIRED_RUNTIME_PATHS = [
+  "AGENTS.md",
+  ".pi/APPEND_SYSTEM.md",
+  ".pi/settings.json",
+  ".pi/extensions/egregore.ts",
+  ".codex/skills",
+  "bin/agent.sh",
+  "bin/pi-branch-policy.mjs",
+  "bin/pi-session-start.sh",
+  "bin/codex-session-start.sh",
+  "bin/codex-skill-render.mjs",
+];
+
+function hashBuffer(buffer) {
+  return crypto.createHash("sha256").update(buffer).digest("hex");
+}
+
+function readJson(file, fallback) {
+  try {
+    return JSON.parse(fs.readFileSync(file, "utf8"));
+  } catch {
+    return fallback;
+  }
+}
+
+function listFiles(dir, prefix = "") {
+  if (!fs.existsSync(dir)) return [];
+  const result = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const rel = prefix ? path.join(prefix, entry.name) : entry.name;
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) result.push(...listFiles(full, rel));
+    else if (entry.isFile()) result.push(rel);
+  }
+  return result.sort();
+}
+
+function bundleManifest() {
+  return readJson(BUNDLE_MANIFEST, { files: [], skills: [], skillCount: 0 });
+}
+
+function bundleFiles() {
+  return listFiles(BUNDLE_DIR).filter((rel) => rel !== "manifest.json");
+}
+
+function installManifestPath(egregoreDir) {
+  const gitPath = path.join(egregoreDir, ".git");
+  try {
+    const stat = fs.lstatSync(gitPath);
+    if (stat.isDirectory()) return path.join(gitPath, "info", "egregore-pi-runtime.json");
+    if (stat.isFile()) {
+      const match = fs.readFileSync(gitPath, "utf8").trim().match(/^gitdir:\s*(.+)$/);
+      if (match) {
+        const gitDir = path.isAbsolute(match[1]) ? match[1] : path.resolve(egregoreDir, match[1]);
+        return path.join(gitDir, "info", "egregore-pi-runtime.json");
+      }
+    }
+  } catch {}
+  return path.join(egregoreDir, LOCAL_MANIFEST);
+}
+
+function pathExists(file) {
+  try {
+    fs.lstatSync(file);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function copyFile(src, dest) {
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+  try { fs.chmodSync(dest, fs.statSync(src).mode & 0o777); } catch {}
+}
+
+function installPiRuntime(egregoreDir) {
+  if (!fs.existsSync(BUNDLE_DIR)) throw new Error(`Pi runtime bundle missing: ${BUNDLE_DIR}`);
+
+  const previousPath = installManifestPath(egregoreDir);
+  const previous = readJson(previousPath, { files: {} });
+  const previousFiles = previous.files || {};
+  const next = {
+    package: PACKAGE.name,
+    version: PACKAGE.version,
+    installedAt: new Date().toISOString(),
+    files: {},
+  };
+  const summary = {
+    installed: 0,
+    updated: 0,
+    skipped: 0,
+    conflicted: 0,
+    conflicts: [],
+    files: [],
+    bundleSkills: bundleManifest().skills || [],
+    bundleSkillCount: bundleManifest().skillCount || 0,
+  };
+
+  for (const rel of bundleFiles()) {
+    const src = path.join(BUNDLE_DIR, rel);
+    const dest = path.join(egregoreDir, rel);
+    const sourceHash = hashBuffer(fs.readFileSync(src));
+    const previousHash = previousFiles[rel]?.hash;
+    const record = () => {
+      next.files[rel] = { hash: sourceHash };
+      summary.files.push(rel);
+    };
+
+    if (!pathExists(dest)) {
+      copyFile(src, dest);
+      summary.installed += 1;
+      record();
+      continue;
+    }
+
+    let stat;
+    try { stat = fs.lstatSync(dest); } catch {}
+    if (!stat?.isFile()) {
+      summary.conflicted += 1;
+      summary.conflicts.push(rel);
+      if (previousHash) next.files[rel] = { hash: previousHash };
+      continue;
+    }
+
+    const currentHash = hashBuffer(fs.readFileSync(dest));
+    if (currentHash === sourceHash) {
+      try { fs.chmodSync(dest, fs.statSync(src).mode & 0o777); } catch {}
+      summary.skipped += 1;
+      record();
+    } else if (previousHash && currentHash === previousHash) {
+      copyFile(src, dest);
+      summary.updated += 1;
+      record();
+    } else {
+      summary.conflicted += 1;
+      summary.conflicts.push(rel);
+      if (previousHash) next.files[rel] = { hash: previousHash };
+    }
+  }
+
+  fs.mkdirSync(path.dirname(previousPath), { recursive: true });
+  fs.writeFileSync(previousPath, JSON.stringify(next, null, 2) + "\n");
+  return summary;
+}
+
+function hasPiRuntimeSupport(egregoreDir) {
+  return REQUIRED_RUNTIME_PATHS.every((rel) => fs.existsSync(path.join(egregoreDir, rel)));
+}
+
+function reportPiRuntimeSummary(summary, ui, opts = {}) {
+  if (!summary || !ui) return;
+  const label = opts.label || "Pi meta-harness";
+  const changed = summary.installed + summary.updated;
+  if (changed > 0) {
+    ui.success(`${label} ready (${summary.installed} installed, ${summary.updated} updated, ${summary.skipped} unchanged)`);
+  }
+  if (opts.includeConflicts !== false && summary.conflicted > 0) {
+    const count = summary.conflicted;
+    ui.info(ui.dim
+      ? ui.dim(`${label}: kept ${count} framework file${count === 1 ? "" : "s"} this Egregore already manages.`)
+      : `${label}: kept ${count} framework file${count === 1 ? "" : "s"} this Egregore already manages.`);
+  }
+}
+
+module.exports = {
+  BUNDLE_DIR,
+  bundleFiles,
+  bundleManifest,
+  hasPiRuntimeSupport,
+  installManifestPath,
+  installPiRuntime,
+  reportPiRuntimeSummary,
+};

package/lib/setup.js

@@ -12,6 +12,11 @@ const {
   installCodexRuntime,
   reportCodexRuntimeSummary,
 } = require("./codex-runtime");
+const {
+  hasPiRuntimeSupport,
+  installPiRuntime,
+  reportPiRuntimeSummary,
+} = require("./pi-runtime");
 
 const https = require("node:https");
 
@@ -438,7 +443,7 @@ async function install(data, ui, targetDir, opts = {}) {
     } catch {}
   }
 
-  // 4d. Overlay packaged Codex support — Codex installs only. Claude Code reads
+  // 4d. Overlay the selected shell-runtime support. Claude Code reads
   // CLAUDE.md, not AGENTS.md; overlaying the Codex AGENTS.md/.codex into a Claude
   // workspace gives a wandering agent a competing startup protocol (the
   // xenocracy onboarding regression). Claude joiners keep the cloned repo as-is —
@@ -447,6 +452,9 @@ async function install(data, ui, targetDir, opts = {}) {
   if (preferredRuntime === "codex") {
     const codexRuntime = installCodexRuntime(egregoreDir);
     reportCodexRuntimeSummary(codexRuntime, ui);
+  } else if (preferredRuntime === "pi") {
+    const piRuntime = installPiRuntime(egregoreDir);
+    reportPiRuntimeSummary(piRuntime, ui);
   }
 
   // 5. Register instance + install launcher binary
@@ -675,23 +683,40 @@ function normalizeRuntime(runtime) {
   const raw = String(runtime || "claude-code").trim().toLowerCase();
   if (raw === "claude" || raw === "claude-code" || raw === "claude_code") return "claude-code";
   if (raw === "codex" || raw === "openai-codex" || raw === "openai_codex") return "codex";
+  if (raw === "pi" || raw === "pi-coding-agent" || raw === "pi_coding_agent") return "pi";
   throw new Error(`Unsupported Egregore runtime: ${runtime}`);
 }
 
 function runtimeDisplay(runtime) {
-  return normalizeRuntime(runtime) === "codex" ? "Codex" : "Claude Code";
+  const normalized = normalizeRuntime(runtime);
+  if (normalized === "codex") return "Codex";
+  if (normalized === "pi") return "Pi";
+  return "Claude Code";
 }
 
 function runtimeBinary(runtime) {
-  return normalizeRuntime(runtime) === "codex" ? "codex" : "claude";
+  const normalized = normalizeRuntime(runtime);
+  if (normalized === "codex") return "codex";
+  if (normalized === "pi") return "pi";
+  return "claude";
 }
 
 // One-line install command for the chosen assistant — shown when the
 // install finishes on a machine that doesn't have the assistant yet.
 function assistantInstallCommand(runtime) {
-  return normalizeRuntime(runtime) === "codex"
-    ? "npm install -g @openai/codex"
-    : "npm install -g @anthropic-ai/claude-code";
+  const normalized = normalizeRuntime(runtime);
+  if (normalized === "codex") return "npm install -g @openai/codex";
+  if (normalized === "pi") return "npm install -g --ignore-scripts @earendil-works/pi-coding-agent";
+  return "npm install -g @anthropic-ai/claude-code";
+}
+
+function piTrustArgs() {
+  try {
+    const help = spawnSync("pi", ["--help"], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+    return `${help.stdout || ""}\n${help.stderr || ""}`.includes("--approve") ? ["--approve"] : [];
+  } catch {
+    return [];
+  }
 }
 
 function runtimeLaunchArgs(runtime, egregoreDir) {
@@ -703,6 +728,7 @@ function runtimeLaunchArgs(runtime, egregoreDir) {
       "--cd", egregoreDir,
     ];
   }
+  if (normalizeRuntime(runtime) === "pi") return piTrustArgs();
   return ["start"];
 }
 
@@ -790,6 +816,16 @@ function hasCodexCoreSupport(egregoreDir) {
   return hasCodexRuntimeSupport(egregoreDir);
 }
 
+function piSupportMessage(egregoreDir) {
+  return [
+    "Pi meta-harness support is missing from this Egregore checkout.",
+    `  path: ${egregoreDir}`,
+    "",
+    "Run npx -y create-egregore@latest to install the packaged Pi runtime, then rerun egregore.",
+    "Pi loads Egregore through project-local .pi resources and the shared portable skill corpus.",
+  ].join("\n");
+}
+
 function installCodexSkills(egregoreDir) {
   const script = path.join(egregoreDir, "bin", "codex-install-skills.sh");
   if (!fs.existsSync(script)) return false;
@@ -887,12 +923,11 @@ async function launchOrInstruct(egregoreDir, alias, ui, ctx = {}) {
   }
 
   if (!commandExists(binary)) {
-    const hasClaude = commandExists("claude");
-    const hasCodex = commandExists("codex");
+    const available = ["claude-code", "codex", "pi"].filter((candidate) => commandExists(runtimeBinary(candidate)));
     // The user already chose `runtime` at the picker — lead with installing
     // THAT one ("install Codex first"), then offer the other as an alternative.
-    const other = runtime === "codex" ? "claude-code" : "codex";
-    if (!hasClaude && !hasCodex) {
+    const other = available[0] || ["claude-code", "codex", "pi"].find((candidate) => candidate !== runtime);
+    if (available.length === 0) {
       ui.warn(`Almost there — install ${display} to start sessions.`);
       ui.info(`  Install ${display} first:`);
       ui.info(`    ${ui.bold(assistantInstallCommand(runtime))}`);
@@ -910,7 +945,8 @@ async function launchOrInstruct(egregoreDir, alias, ui, ctx = {}) {
     return;
   }
 
-  ui.info(`Starting Egregore in ${ui.bold(display)} now — press ${ui.bold("Ctrl+D")} (or /exit) to return to your shell.`);
+  const quitCommand = runtime === "pi" ? "/quit" : "/exit";
+  ui.info(`Starting Egregore in ${ui.bold(display)} now — press ${ui.bold("Ctrl+D")} (or ${quitCommand}) to return to your shell.`);
   ui.info(`Next time, ${launcherNextStep(ui, aliasName)}`);
   console.log("");
 
@@ -931,6 +967,15 @@ async function launchOrInstruct(egregoreDir, alias, ui, ctx = {}) {
       console.log("");
       return;
     }
+  } else if (runtime === "pi") {
+    const piRuntime = installPiRuntime(egregoreDir);
+    reportPiRuntimeSummary(piRuntime, ui);
+    if (!hasPiRuntimeSupport(egregoreDir)) {
+      ui.warn(piSupportMessage(egregoreDir));
+      ui.info(`Run ${ui.bold(aliasName)} after updating the checkout.`);
+      console.log("");
+      return;
+    }
   }
 
   const result = spawnSync(binary, runtimeLaunchArgs(runtime, egregoreDir), {

package/lib/ui.js

@@ -1358,7 +1358,7 @@ function _renderWelcomeBody({ w, h, version }) {
   lines.push(`${DIM}└${"─".repeat(panelInner)}┘${RESET}`);
 
   lines.push("");
-  lines.push(`${DIM}a shared memory layer for teams using Claude Code or Codex${RESET}`);
+  lines.push(`${DIM}shared memory across Claude Code, Codex, and Pi${RESET}`);
   lines.push("");
   lines.push(`${DIM}press ${RESET}${BOLD}↵${RESET}${DIM} to begin · ctrl-c to exit${RESET}`);
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-egregore",
-  "version": "0.19.5",
-  "description": "Set up Egregore for your team in one command — installs the egregore launcher and your choice of Claude Code or Codex.",
+  "version": "0.19.7",
+  "description": "Set up Egregore for your team in one command — installs the egregore launcher and your choice of Claude Code, Codex, or Pi.",
   "license": "MIT",
   "bin": {
     "create-egregore": "./bin/cli.js"
@@ -10,10 +10,11 @@
     "node": ">=18"
   },
   "scripts": {
-    "build:runtime": "node scripts/build-runtime-bundle.mjs",
-    "test": "node scripts/build-runtime-bundle.mjs --check && node --test test/context.test.js test/parse-join-target.test.js test/skip-repos.test.js test/onboarding-shortcircuit.test.js test/welcome-screen.test.js test/runtime-selection.test.js test/command-generation.test.js test/auth-gh.test.js test/gauntlet-fixes.test.js test/codex-runtime.test.js test/installer-runtime-source.test.js test/scroll-repro.test.js test/launcher-refocus-redraw.test.js test/multiselect-remote-search.test.js test/back-navigation.test.js test/manifest-form.test.js test/launcher-delete.test.js",
+    "build:runtime": "node scripts/build-runtime-bundle.mjs && node scripts/build-pi-runtime-bundle.mjs",
+    "build:pi-runtime": "node scripts/build-pi-runtime-bundle.mjs",
+    "test": "node scripts/build-runtime-bundle.mjs --check && node scripts/build-pi-runtime-bundle.mjs --check && node --test test/context.test.js test/parse-join-target.test.js test/skip-repos.test.js test/onboarding-shortcircuit.test.js test/welcome-screen.test.js test/runtime-selection.test.js test/command-generation.test.js test/auth-gh.test.js test/gauntlet-fixes.test.js test/codex-runtime.test.js test/pi-runtime.test.js test/pi-product-workflows.test.js test/installer-runtime-source.test.js test/scroll-repro.test.js test/launcher-refocus-redraw.test.js test/multiselect-remote-search.test.js test/back-navigation.test.js test/manifest-form.test.js test/launcher-delete.test.js",
     "test:e2e": "node --test test/e2e-local.test.js",
-    "test:all": "node scripts/build-runtime-bundle.mjs --check && node --test test/"
+    "test:all": "node scripts/build-runtime-bundle.mjs --check && node scripts/build-pi-runtime-bundle.mjs --check && node --test test/"
   },
   "files": [
     "bin/",
@@ -25,6 +26,7 @@
     "egregore",
     "claude",
     "codex",
+    "pi",
     "ai",
     "collaboration"
   ],

package/runtime/codex/.codex/spec-manifest.json

@@ -11,7 +11,7 @@
     {
       "section": "Identity & Upstream",
       "action": "keep",
-      "sourceHash": "11d07e3fcb58",
+      "sourceHash": "ddcbc0083aff",
       "note": "Kept; /update, /contribute, /save tokens rendered as $skill tokens."
     },
     {

package/runtime/codex/AGENTS.md

@@ -9,6 +9,11 @@
 > Egregore skill already covers. This file exists only for runtimes that cannot
 > read `CLAUDE.md`.
 >
+> **If you are Pi** (the `pi` coding-agent harness): **stop here.** Your
+> authoritative Egregore instructions are loaded from
+> `.pi/APPEND_SYSTEM.md`, and your workflows are exposed through the
+> project-local `.pi/` runtime. Do not follow the Codex-specific block below.
+>
 > **If you are Codex or another shell-only agent:** this file is yours — continue.
 
 Egregore is no longer only a Claude Code workspace. Claude Code remains the
@@ -80,7 +85,7 @@ This block is the Codex-native Egregore behavioral spec, rendered from CLAUDE.md
 
 ## Identity & Upstream
 
-This is an Egregore instance — a downstream fork of the upstream framework at `egregore-labs/egregore`. The framework (`bin/`, `.claude/skills/`, `.claude/hooks/`, `.claude/context/`, `.claude/agents/`, `loom/`, `CLAUDE.md`, `skills/`) is synced from upstream on every session start and via `$update`. It is not authored in this repo.
+This is an Egregore instance — a downstream fork of the upstream framework at `egregore-labs/egregore`. The framework (`bin/`, `.claude/skills/`, `.claude/hooks/`, `.claude/context/`, `.claude/agents/`, `.pi/`, `loom/`, `CLAUDE.md`, `skills/`) is synced from upstream on every session start and via `$update`. It is not authored in this repo.
 
 **Where changes belong:**
 - **Framework is outdated or a skill is missing:** run `$update` first. It pulls the latest from upstream.
@@ -93,7 +98,7 @@ When a user reports broken or missing framework behavior, the first question is
 
 ## On Launch — MANDATORY FIRST ACTION
 
-The `egregore` launcher renders the Egregore startup card (identity, handoffs, team activity) via `bin/codex-session-start.sh` before Codex starts, and installs project skills. Do not rerun startup checks and do not narrate startup. The card ends with **"What are you working on?"** — that question is already on screen; treat the user's first message as the answer to it. To re-show the card, run `bash bin/codex-session-start.sh --card`.
+The `egregore` launcher renders the Egregore startup card (identity, team momentum, and pending work) via `bin/codex-session-start.sh` before Codex starts, and installs project skills. Do not rerun startup checks and do not narrate startup. The card ends with **"What are you working on?"** — that question is already on screen; treat the user's first message as the answer to it. To re-show the card, run `bash bin/codex-session-start.sh --card`.
 
 ---
 

package/runtime/codex/bin/codex-render-spec.mjs

@@ -53,6 +53,11 @@ const AGENTS_PREAMBLE = `# Egregore Agent Protocol
 > Egregore skill already covers. This file exists only for runtimes that cannot
 > read \`CLAUDE.md\`.
 >
+> **If you are Pi** (the \`pi\` coding-agent harness): **stop here.** Your
+> authoritative Egregore instructions are loaded from
+> \`.pi/APPEND_SYSTEM.md\`, and your workflows are exposed through the
+> project-local \`.pi/\` runtime. Do not follow the Codex-specific block below.
+>
 > **If you are Codex or another shell-only agent:** this file is yours — continue.
 
 Egregore is no longer only a Claude Code workspace. Claude Code remains the
@@ -169,7 +174,7 @@ const INTRO_BODY = `You are a collaborator inside Egregore — a shared intellig
 
 This block is the Codex-native Egregore behavioral spec, rendered from CLAUDE.md (the source of truth for egregore behavior) by \`bin/codex-render-spec.mjs\`. The per-section adaptation manifest is \`.codex/spec-manifest.json\`. The thin agent protocol above this block applies to every shell-capable agent; this block is the full behavioral contract for Codex sessions.`;
 
-const ON_LAUNCH_BODY = `The \`egregore\` launcher renders the Egregore startup card (identity, handoffs, team activity) via \`bin/codex-session-start.sh\` before Codex starts, and installs project skills. Do not rerun startup checks and do not narrate startup. The card ends with **"What are you working on?"** — that question is already on screen; treat the user's first message as the answer to it. To re-show the card, run \`bash bin/codex-session-start.sh --card\`.`;
+const ON_LAUNCH_BODY = `The \`egregore\` launcher renders the Egregore startup card (identity, team momentum, and pending work) via \`bin/codex-session-start.sh\` before Codex starts, and installs project skills. Do not rerun startup checks and do not narrate startup. The card ends with **"What are you working on?"** — that question is already on screen; treat the user's first message as the answer to it. To re-show the card, run \`bash bin/codex-session-start.sh --card\`.`;
 
 const AFTER_GREETING_BODY = `**Mandatory behavioral rule.** When the user describes work, your **first action** — before reading files, exploring code, or anything else — is to get onto a working branch: