@yorz/cli 0.9.2 → 0.10.1

package/dist/cli/index.js

@@ -2,16 +2,16 @@
 import { homedir, platform } from "node:os";
 import { Command, Option } from "commander";
 import { stat, mkdir, writeFile, rename, readFile, rm, access, cp, readdir, appendFile, copyFile } from "node:fs/promises";
-import { join, isAbsolute, resolve, basename as basename$1, dirname, extname, relative, sep, normalize } from "node:path";
+import { posix, win32, join, isAbsolute, resolve, basename as basename$1, dirname, extname, relative, sep, normalize } from "node:path";
 import { createHash, randomUUID, randomBytes } from "node:crypto";
-import { existsSync, openSync, closeSync, statSync, readSync, mkdirSync, watch, createReadStream } from "node:fs";
+import { existsSync, constants, openSync, closeSync, statSync, readSync, mkdirSync, watch, createReadStream } from "node:fs";
 import { execFile, spawn, execFileSync } from "node:child_process";
 import { promisify } from "node:util";
+import { fileURLToPath } from "node:url";
 import { serve } from "@hono/node-server";
 import { isIP } from "node:net";
 import { Hono } from "hono";
 import { streamSSE } from "hono/streaming";
-import { fileURLToPath } from "node:url";
 import trash from "trash";
 import matter from "gray-matter";
 import chokidar from "chokidar";
@@ -20,14 +20,15 @@ import { listSessions, getSessionMessages, query } from "@anthropic-ai/claude-ag
 import { createInterface } from "node:readline";
 import { Codex } from "@openai/codex-sdk";
 import { createOpencode } from "@opencode-ai/sdk";
+import { ModelRuntime, SessionManager as SessionManager$1, createAgentSession } from "@earendil-works/pi-coding-agent";
 import { createInterface as createInterface$1 } from "node:readline/promises";
 import MarkdownIt from "markdown-it";
 const name = "@yorz/cli";
-const version = "0.9.2";
+const version = "0.10.1";
 const type = "module";
 const description = "";
 const bin = { "yorz": "./dist/cli/index.js" };
-const engines = { "node": ">=20" };
+const engines = { "node": ">=22.19.0" };
 const files = ["dist", "README.md"];
 const keywords = ["ai", "agent", "spec-driven", "decision-os", "claude-code", "opencode", "workflow", "cli"];
 const license = "LGPL-3.0-or-later";
@@ -35,7 +36,7 @@ const repository = { "type": "git", "url": "git+https://github.com/hughfenghen/Y
 const homepage = "https://github.com/hughfenghen/YorZ#readme";
 const publishConfig = { "access": "public" };
 const scripts = { "build": "pnpm run build:cli && pnpm run build:gui && pnpm run build:gui-mobile", "build:cli": "vite build", "build:gui": "vite build --config vite.gui.config.ts", "build:gui-mobile": "vite build --config vite.gui-mobile.config.ts", "dev:cli": "pnpm run build:cli && node dist/cli/index.js serve --port 7424 --foreground", "dev:gui": "vite --config vite.gui.config.ts", "dev:gui-mobile": "vite --config vite.gui-mobile.config.ts", "gen:mobile-icons": "node scripts/gen-mobile-icons.mjs", "typecheck": "tsc -b", "test": "vitest run", "test:agent": "node scripts/test-agent.mjs", "test:e2e": "pnpm run build && playwright test", "format": 'prettier --write "src/**/*.{ts,tsx,md,css}"', "prepare": "node scripts/setup-git-hooks.mjs", "prepublishOnly": "pnpm run build" };
-const dependencies = { "@anthropic-ai/claude-agent-sdk": "^0.3.207", "@hono/node-server": "^2.0.4", "@openai/codex-sdk": "^0.144.1", "@opencode-ai/sdk": "^1.17.18", "chokidar": "^5.0.0", "commander": "^12.1.0", "gray-matter": "^4.0.3", "hono": "^4.12.25", "jsdom": "^25.0.1", "markdown-it": "^14.2.0", "mermaid": "^11.0.0", "morphdom": "^2.7.8", "parse-diff": "^0.12.0", "timeago.js": "^4.0.2", "trash": "^10.1.1" };
+const dependencies = { "@anthropic-ai/claude-agent-sdk": "^0.3.207", "@earendil-works/pi-coding-agent": "^0.85.1", "@hono/node-server": "^2.0.4", "@openai/codex-sdk": "^0.144.1", "@opencode-ai/sdk": "^1.17.18", "chokidar": "^5.0.0", "commander": "^12.1.0", "gray-matter": "^4.0.3", "hono": "^4.12.25", "jsdom": "^25.0.1", "markdown-it": "^14.2.0", "mermaid": "^11.0.0", "morphdom": "^2.7.8", "parse-diff": "^0.12.0", "timeago.js": "^4.0.2", "trash": "^10.1.1" };
 const devDependencies = { "@fontsource/jetbrains-mono": "^5.3.0", "@kobalte/core": "^0.13.12", "@playwright/test": "^1.61.0", "@solidjs/router": "^0.16.1", "@types/jsdom": "^21.1.7", "@types/markdown-it": "^14.1.2", "@types/node": "^22.10.0", "autoprefixer": "^10.5.2", "class-variance-authority": "^0.7.1", "clsx": "^2.1.1", "concurrently": "^9.1.0", "highlight.js": "^11.11.1", "i18next": "^26.3.6", "i18next-browser-languagedetector": "^8.2.1", "lucide-solid": "^1.24.0", "markdown-it-task-lists": "^2.1.1", "postcss": "^8.5.16", "prettier": "^3.4.0", "solid-js": "^1.9.13", "tailwind-merge": "^3.6.0", "tailwindcss": "^3.4.19", "tailwindcss-animate": "^1.0.7", "typescript": "^5.7.0", "vite": "^6.0.0", "vite-plugin-pwa": "^1.3.0", "vite-plugin-solid": "^2.11.12", "vitest": "^2.1.0", "workbox-window": "^7.4.1" };
 const pkg = {
   name,
@@ -141,6 +142,20 @@ function mergeCustomInstructions(project, global) {
   const names = new Set(project.map((item) => item.name));
   return [...project, ...global.filter((item) => !names.has(item.name))];
 }
+function normalizeAbsPath(input, platform2 = process.platform, cwd = process.cwd()) {
+  const trimmed = input.trim();
+  if (platform2 !== "win32") return posix.resolve(cwd, trimmed);
+  const resolved = win32.resolve(cwd, trimmed);
+  return upperDriveLetter(resolved);
+}
+function samePath(a, b, platform2 = process.platform) {
+  if (platform2 !== "win32") return a === b;
+  return a.toLowerCase() === b.toLowerCase();
+}
+function upperDriveLetter(p) {
+  if (/^[a-z]:/.test(p)) return p[0].toUpperCase() + p.slice(1);
+  return p;
+}
 const CURRENT_VERSION$1 = 1;
 const DEFAULT_GLOBAL_AGENT = { defaultKind: "claude" };
 const DEFAULT_NOTIFICATIONS = {
@@ -264,7 +279,9 @@ function normalizeAgent$1(value) {
   if (!value || typeof value !== "object") return { defaultKind: DEFAULT_GLOBAL_AGENT.defaultKind };
   const obj = value;
   const defaultKind = obj.defaultKind;
-  if (defaultKind === "opencode" || defaultKind === "codex") return { defaultKind };
+  if (defaultKind === "opencode" || defaultKind === "codex" || defaultKind === "pi") {
+    return { defaultKind };
+  }
   return { defaultKind: "claude" };
 }
 function normalizeNotifications(value) {
@@ -391,9 +408,9 @@ function generateProjectId(absPath, depth = 0) {
 function slugify(text) {
   return text.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40).replace(/-+$/, "");
 }
-async function addProject(absPath, filePath, now = () => /* @__PURE__ */ new Date()) {
+async function addProject(absPath, filePath, now = () => /* @__PURE__ */ new Date(), platform2 = process.platform) {
   const config = await loadGlobalConfig(filePath);
-  const existing = config.projects.find((p) => p.path === absPath);
+  const existing = config.projects.find((p) => samePath(p.path, absPath, platform2));
   if (existing) return { entry: existing, created: false };
   const entry = {
     id: generateProjectId(absPath),
@@ -507,13 +524,10 @@ async function isGitRepo(cwd) {
     return false;
   }
 }
-async function runGitInit(cwd) {
+async function runGitInit(cwd, opts = {}) {
+  const stdio = opts.stdio ?? "inherit";
   await new Promise((resolve2, reject) => {
-    const child = spawn(
-      "git",
-      ["init"],
-      withHiddenWindowsConsole({ cwd, stdio: "inherit" })
-    );
+    const child = spawn("git", ["init"], withHiddenWindowsConsole({ cwd, stdio }));
     child.on("error", reject);
     child.on("exit", (code) => {
       if (code === 0) resolve2();
@@ -521,6 +535,34 @@ async function runGitInit(cwd) {
     });
   });
 }
+async function ensureTmpIgnored(cwd) {
+  if (!await isGitRepo(cwd)) return null;
+  const giPath = join(cwd, ".gitignore");
+  let existing = "";
+  try {
+    existing = await readFile(giPath, "utf8");
+  } catch {
+    existing = "";
+  }
+  if (hasIgnoreEntry(existing, ".yorz/tmp")) {
+    return { updated: false, path: giPath };
+  }
+  const needsNewline = existing.length > 0 && !existing.endsWith("\n");
+  const next = `${existing}${needsNewline ? "\n" : ""}.yorz/tmp
+`;
+  await writeFile(giPath, next, "utf8");
+  return { updated: true, path: giPath };
+}
+function hasIgnoreEntry(content, target) {
+  const normalized = target.replace(/\/$/, "");
+  for (const rawLine of content.split("\n")) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#")) continue;
+    const cleaned = line.replace(/\/$/, "").replace(/^\//, "");
+    if (cleaned === normalized) return true;
+  }
+  return false;
+}
 const SKILL_DIR_NAME = "yorz-spec";
 const SKILL_DIR_NAMES = ["yorz-spec", "yorz-debug", "yorz-git-ops"];
 const SKILL_FILES = /* @__PURE__ */ Object.assign({
@@ -705,34 +747,6 @@ async function dirExists(path) {
     return false;
   }
 }
-function hasIgnoreEntry(content, target) {
-  const normalized = target.replace(/\/$/, "");
-  for (const rawLine of content.split("\n")) {
-    const line = rawLine.trim();
-    if (!line || line.startsWith("#")) continue;
-    const cleaned = line.replace(/\/$/, "").replace(/^\//, "");
-    if (cleaned === normalized) return true;
-  }
-  return false;
-}
-async function ensureTmpIgnored(cwd) {
-  if (!await isGitRepo(cwd)) return null;
-  const giPath = join(cwd, ".gitignore");
-  let existing = "";
-  try {
-    existing = await readFile(giPath, "utf8");
-  } catch {
-    existing = "";
-  }
-  if (hasIgnoreEntry(existing, ".yorz/tmp")) {
-    return { updated: false, path: giPath };
-  }
-  const needsNewline = existing.length > 0 && !existing.endsWith("\n");
-  const next = `${existing}${needsNewline ? "\n" : ""}.yorz/tmp
-`;
-  await writeFile(giPath, next, "utf8");
-  return { updated: true, path: giPath };
-}
 async function uninstall(opts = {}) {
   const baseDir = opts.skillsDir ?? resolveGlobalSkillsDir();
   const results = [];
@@ -1479,39 +1493,50 @@ function findProjectRoot(startDir) {
 function normalizeUsage(kind, raw) {
   if (!raw || typeof raw !== "object") return void 0;
   const obj = raw;
-  const snapshot = kind === "codex" ? fromCodex(obj) : kind === "opencode" ? fromOpenCode(obj) : fromClaude(obj);
+  const snapshot = kind === "codex" ? fromCodex(obj) : kind === "opencode" ? fromOpenCode(obj) : kind === "pi" ? fromPi(obj) : fromClaude(obj);
   return isEmpty(snapshot) ? void 0 : snapshot;
 }
 function fromClaude(u) {
   return compact({
-    inputTokens: num$2(u.input_tokens),
-    outputTokens: num$2(u.output_tokens),
-    cacheReadTokens: num$2(u.cache_read_input_tokens),
-    cacheCreateTokens: num$2(u.cache_creation_input_tokens)
+    inputTokens: num$3(u.input_tokens),
+    outputTokens: num$3(u.output_tokens),
+    cacheReadTokens: num$3(u.cache_read_input_tokens),
+    cacheCreateTokens: num$3(u.cache_creation_input_tokens)
   });
 }
 function fromCodex(u) {
-  const total = num$2(u.input_tokens);
-  const cached = num$2(u.cached_input_tokens);
+  const total = num$3(u.input_tokens);
+  const cached = num$3(u.cached_input_tokens);
   const uncached = total !== void 0 && cached !== void 0 ? Math.max(total - cached, 0) : total;
   return compact({
     inputTokens: uncached,
     cacheReadTokens: cached,
-    outputTokens: num$2(u.output_tokens),
-    reasoningTokens: num$2(u.reasoning_output_tokens)
+    outputTokens: num$3(u.output_tokens),
+    reasoningTokens: num$3(u.reasoning_output_tokens)
   });
 }
 function fromOpenCode(u) {
   const cache = u.cache && typeof u.cache === "object" ? u.cache : {};
   return compact({
-    inputTokens: num$2(u.input),
-    outputTokens: num$2(u.output),
-    reasoningTokens: num$2(u.reasoning),
-    cacheReadTokens: num$2(cache.read),
-    cacheCreateTokens: num$2(cache.write)
+    inputTokens: num$3(u.input),
+    outputTokens: num$3(u.output),
+    reasoningTokens: num$3(u.reasoning),
+    cacheReadTokens: num$3(cache.read),
+    cacheCreateTokens: num$3(cache.write)
   });
 }
-function num$2(value) {
+function fromPi(u) {
+  const cost = u.cost && typeof u.cost === "object" ? u.cost : {};
+  return compact({
+    inputTokens: num$3(u.input),
+    outputTokens: num$3(u.output),
+    cacheReadTokens: num$3(u.cacheRead),
+    cacheCreateTokens: num$3(u.cacheWrite),
+    reasoningTokens: num$3(u.reasoning),
+    costUsd: num$3(cost.total)
+  });
+}
+function num$3(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
 function compact(snapshot) {
@@ -2344,6 +2369,7 @@ function normalizeAgent(value) {
   if (typeof value === "string") {
     if (value === "opencode") return { kind: "opencode" };
     if (value === "codex") return { kind: "codex" };
+    if (value === "pi") return { kind: "pi" };
     return { kind: "claude" };
   }
   if (!value || typeof value !== "object") return { kind: "claude" };
@@ -2352,12 +2378,7 @@ function normalizeAgent(value) {
   if (kind === "inherit") return { kind: "inherit" };
   if (kind === "opencode") return { kind: "opencode" };
   if (kind === "codex") return { kind: "codex" };
-  if (kind === "custom") {
-    const cmd = typeof obj.cmd === "string" ? obj.cmd.trim() : "";
-    if (!cmd) return { kind: "claude" };
-    const args = Array.isArray(obj.args) ? obj.args.filter((a) => typeof a === "string") : [];
-    return { kind: "custom", cmd, args };
-  }
+  if (kind === "pi") return { kind: "pi" };
   return { kind: "claude" };
 }
 function normalizeSpecsDir(value) {
@@ -2373,7 +2394,7 @@ async function loadCustomInstructions(projectPath) {
   ]);
   return mergeCustomInstructions(project, global);
 }
-const KINDS = ["claude", "codex", "opencode"];
+const KINDS = ["claude", "codex", "opencode", "pi"];
 const DRAFT_ID_RE = /^[a-zA-Z0-9-]{1,64}$/;
 function buildChatPrompt(prompt, draftId, attachments) {
   if (attachments.length === 0) return prompt;
@@ -3427,6 +3448,39 @@ function createEventsRoutes(resolveProject, registry, projectsBus, systemNotific
   });
   return app;
 }
+class NeedGitInitError extends Error {
+  path;
+  constructor(absPath) {
+    super(`target directory is not a git repository: ${absPath}`);
+    this.name = "NeedGitInitError";
+    this.path = absPath;
+  }
+}
+async function addProjectWithGit(opts) {
+  const platform2 = opts.platform ?? process.platform;
+  if (typeof opts.path !== "string" || !opts.path.trim()) {
+    throw new Error("path required");
+  }
+  const abs = normalizeAbsPath(opts.path, platform2, opts.cwd);
+  if (!existsSync(abs)) {
+    throw new Error(`path does not exist: ${abs}`);
+  }
+  const stats = await stat(abs);
+  if (!stats.isDirectory()) {
+    throw new Error(`path is not a directory: ${abs}`);
+  }
+  let gitInitialized = false;
+  if (!await isGitRepo(abs)) {
+    if (!opts.gitInit) throw new NeedGitInitError(abs);
+    const init = opts.runGitInit ?? ((cwd) => runGitInit(cwd, { stdio: "ignore" }));
+    await init(abs);
+    gitInitialized = true;
+  }
+  await prepareProjectDir(abs, opts.cwd);
+  const gitignore = await ensureTmpIgnored(abs);
+  const { entry, created } = await addProject(abs, opts.globalConfigPath, void 0, platform2);
+  return { entry, created, gitInitialized, gitignore };
+}
 function createProjectRoutes(registry, worktreeManager) {
   const app = new Hono();
   app.get("/projects", async (c) => {
@@ -3440,7 +3494,8 @@ function createProjectRoutes(registry, worktreeManager) {
     } catch {
       return c.json({ error: "invalid JSON body" }, 400);
     }
-    const path = body?.path;
+    const raw = body;
+    const path = raw?.path;
     if (typeof path !== "string" || !path.trim()) {
       return c.json({ error: "path required" }, 400);
     }
@@ -3448,7 +3503,7 @@ function createProjectRoutes(registry, worktreeManager) {
     if (!isAbsolute(trimmed)) {
       return c.json({ error: "path must be absolute" }, 400);
     }
-    const normalized = resolve(trimmed);
+    const normalized = normalizeAbsPath(trimmed);
     if (!existsSync(normalized)) {
       return c.json({ error: `path does not exist: ${normalized}` }, 400);
     }
@@ -3457,7 +3512,7 @@ function createProjectRoutes(registry, worktreeManager) {
       return c.json({ error: `path is not a directory: ${normalized}` }, 400);
     }
     try {
-      const result = await registry.add(normalized);
+      const result = await registry.addWithGit(normalized, { gitInit: raw?.gitInit === true });
       return c.json(
         {
           id: result.entry.id,
@@ -3468,6 +3523,9 @@ function createProjectRoutes(registry, worktreeManager) {
         result.created ? 201 : 200
       );
     } catch (err) {
+      if (err instanceof NeedGitInitError) {
+        return c.json({ error: err.message, needGitInit: true, path: err.path }, 409);
+      }
       return c.json({ error: err.message }, 400);
     }
   });
@@ -3595,27 +3653,8 @@ function parseAgent(value) {
   if (kind === "claude") return { value: { kind: "claude" } };
   if (kind === "opencode") return { value: { kind: "opencode" } };
   if (kind === "codex") return { value: { kind: "codex" } };
-  if (kind === "custom") {
-    const cmd = obj.cmd;
-    if (typeof cmd !== "string" || !cmd.trim()) {
-      return { error: "agent.cmd required when kind=custom" };
-    }
-    if (cmd.length > 500) return { error: "agent.cmd too long (max 500)" };
-    const argsRaw = obj.args;
-    let args = [];
-    if (argsRaw !== void 0) {
-      if (!Array.isArray(argsRaw)) return { error: "agent.args must be an array of strings" };
-      args = [];
-      for (const a of argsRaw) {
-        if (typeof a !== "string") return { error: "agent.args entries must be strings" };
-        if (a.length > 500) return { error: "agent.args entry too long (max 500)" };
-        args.push(a);
-      }
-      if (args.length > 64) return { error: "agent.args too many entries (max 64)" };
-    }
-    return { value: { kind: "custom", cmd: cmd.trim(), args } };
-  }
-  return { error: "agent.kind must be inherit | claude | opencode | codex | custom" };
+  if (kind === "pi") return { value: { kind: "pi" } };
+  return { error: "agent.kind must be inherit | claude | opencode | codex | pi" };
 }
 function parseSpecsDir(value) {
   const fallback = defaultProjectConfig().specsDir;
@@ -3820,8 +3859,8 @@ function parseBody(value) {
   }
   const agentObj = agent;
   const defaultKind = agentObj.defaultKind;
-  if (defaultKind !== "claude" && defaultKind !== "opencode" && defaultKind !== "codex") {
-    return { error: "agent.defaultKind must be claude | opencode | codex" };
+  if (defaultKind !== "claude" && defaultKind !== "opencode" && defaultKind !== "codex" && defaultKind !== "pi") {
+    return { error: "agent.defaultKind must be claude | opencode | codex | pi" };
   }
   const notifications = obj.notifications;
   if (!notifications || typeof notifications !== "object") {
@@ -4238,6 +4277,172 @@ function createProjectFilesRoutes(resolveProject) {
   });
   return app;
 }
+const MAX_ENTRIES = 1e3;
+const WIN_DRIVE_ROOT = "";
+function createFsRoutes(deps = {}) {
+  const platform2 = deps.platform ?? process.platform;
+  const homedir$1 = deps.homedir ?? homedir;
+  const isWin = platform2 === "win32";
+  const p = isWin ? win32 : posix;
+  const app = new Hono();
+  app.get("/fs/list", async (c) => {
+    const rawPath = c.req.query("path");
+    const showHidden = c.req.query("showHidden") === "1";
+    const home = normalizeAbsPath(homedir$1(), platform2);
+    const blank = rawPath === void 0 || rawPath.trim() === "";
+    if (isWin && blank) {
+      const drives = await listWindowsDrives();
+      return c.json({
+        path: WIN_DRIVE_ROOT,
+        parent: null,
+        sep: p.sep,
+        home,
+        entries: drives,
+        truncated: false
+      });
+    }
+    const target = blank ? home : rawPath;
+    if (!p.isAbsolute(target.trim())) {
+      return c.json({ error: "path must be absolute" }, 400);
+    }
+    const dir = normalizeAbsPath(target, platform2);
+    let stats;
+    try {
+      stats = await stat(dir);
+    } catch (err) {
+      return c.json({ error: describeFsError(err, dir) }, 400);
+    }
+    if (!stats.isDirectory()) {
+      return c.json({ error: `path is not a directory: ${dir}` }, 400);
+    }
+    let rawEntries;
+    try {
+      rawEntries = await readdir(dir, { withFileTypes: true });
+    } catch (err) {
+      return c.json({ error: describeFsError(err, dir) }, 400);
+    }
+    const dirs = [];
+    for (const entry of rawEntries) {
+      if (!showHidden && entry.name.startsWith(".")) continue;
+      const full = p.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        dirs.push({ name: entry.name, path: full });
+        continue;
+      }
+      if (!entry.isSymbolicLink()) continue;
+      try {
+        const s = await stat(full);
+        if (s.isDirectory()) dirs.push({ name: entry.name, path: full });
+      } catch {
+      }
+    }
+    dirs.sort((a, b) => a.name.localeCompare(b.name));
+    const truncated = dirs.length > MAX_ENTRIES;
+    return c.json({
+      path: dir,
+      parent: resolveParent(dir, platform2),
+      sep: p.sep,
+      home,
+      entries: truncated ? dirs.slice(0, MAX_ENTRIES) : dirs,
+      truncated
+    });
+  });
+  app.post("/fs/mkdir", async (c) => {
+    let body;
+    try {
+      body = await c.req.json();
+    } catch {
+      return c.json({ error: "invalid json body" }, 400);
+    }
+    const rawParent = typeof body.parent === "string" ? body.parent : "";
+    const rawName = typeof body.name === "string" ? body.name : "";
+    if (!rawParent.trim() || !p.isAbsolute(rawParent.trim())) {
+      return c.json({ error: "parent must be an absolute directory path" }, 400);
+    }
+    const nameError = validateDirName(rawName, platform2);
+    if (nameError) return c.json({ error: nameError }, 400);
+    const parent = normalizeAbsPath(rawParent, platform2);
+    try {
+      const stats = await stat(parent);
+      if (!stats.isDirectory()) {
+        return c.json({ error: `path is not a directory: ${parent}` }, 400);
+      }
+    } catch (err) {
+      return c.json({ error: describeFsError(err, parent) }, 400);
+    }
+    const target = p.join(parent, rawName.trim());
+    try {
+      await mkdir(target);
+    } catch (err) {
+      const code = err?.code;
+      if (code === "EEXIST") return c.json({ error: `already exists: ${target}` }, 409);
+      if (code === "EACCES" || code === "EPERM") {
+        return c.json({ error: `permission denied: ${target}` }, 403);
+      }
+      return c.json({ error: describeFsError(err, target) }, 400);
+    }
+    return c.json({ path: normalizeAbsPath(target, platform2) }, 201);
+  });
+  return app;
+}
+const WIN_RESERVED_NAME = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])(\.|$)/i;
+function validateDirName(name2, platform2) {
+  const value = name2.trim();
+  if (!value) return "name must not be empty";
+  if (value.length > 255) return "name is too long";
+  if (value === "." || value === "..") return 'name must not be "." or ".."';
+  if (value.includes("/") || value.includes("\\")) {
+    return "name must not contain a path separator";
+  }
+  if (/[\u0000-\u001f\u007f]/.test(value)) return "name must not contain control characters";
+  if (platform2 === "win32") {
+    if (/[<>:"|?*]/.test(value)) return 'name must not contain <>:"|?* on Windows';
+    if (WIN_RESERVED_NAME.test(value)) return `"${value}" is a reserved name on Windows`;
+    if (/[. ]$/.test(value)) return "name must not end with a dot or space on Windows";
+  }
+  return null;
+}
+function resolveParent(dir, platform2) {
+  if (platform2 !== "win32") {
+    const parent2 = posix.dirname(dir);
+    return parent2 === dir ? null : parent2;
+  }
+  const root = win32.parse(dir).root;
+  if (dir === root) {
+    return isUncRoot(root) ? null : WIN_DRIVE_ROOT;
+  }
+  const parent = win32.dirname(dir);
+  return parent === dir ? null : parent;
+}
+function isUncRoot(root) {
+  return root.startsWith("\\\\");
+}
+async function listWindowsDrives() {
+  const letters = [];
+  for (let code = "C".charCodeAt(0); code <= "Z".charCodeAt(0); code++) {
+    letters.push(String.fromCharCode(code));
+  }
+  const checked = await Promise.all(
+    letters.map(async (letter) => {
+      const root = `${letter}:\\`;
+      try {
+        await access(root, constants.R_OK);
+        return { name: `${letter}:`, path: root };
+      } catch {
+        return null;
+      }
+    })
+  );
+  return checked.filter((d) => d !== null);
+}
+function describeFsError(err, dir) {
+  const code = err?.code;
+  if (code === "ENOENT") return `path does not exist: ${dir}`;
+  if (code === "ENAMETOOLONG") return `path is too long: ${dir}`;
+  if (code === "EACCES" || code === "EPERM") return `permission denied: ${dir}`;
+  if (code === "ENOTDIR") return `path is not a directory: ${dir}`;
+  return `cannot read directory: ${dir}`;
+}
 class CommandRunStore {
   file;
   cache = null;
@@ -5784,6 +5989,7 @@ function createApp(opts) {
   api.route("/", createSpecDraftsRoutes(resolveProject));
   api.route("/", createWorktreeRoutes(opts.registry, worktreeManager));
   api.route("/", createProjectFilesRoutes(resolveProject));
+  api.route("/", createFsRoutes());
   api.route("/", createCommandsRoutes(resolveProject));
   api.route(
     "/",
@@ -6368,13 +6574,57 @@ class SpecWatcher {
     return parts[0];
   }
 }
+function isRecord$2(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+const SPEC_WRITE_TOOLS = {
+  claude: /* @__PURE__ */ new Set(["Write", "Edit", "MultiEdit", "NotebookEdit"]),
+  codex: /* @__PURE__ */ new Set(),
+  opencode: /* @__PURE__ */ new Set(["write", "edit", "patch"]),
+  pi: /* @__PURE__ */ new Set(["write", "edit"])
+};
+const PATH_KEYS = ["file_path", "filePath", "path"];
+function isSpecWrite(kind, name2, input) {
+  if (typeof name2 !== "string" || !SPEC_WRITE_TOOLS[kind].has(name2)) return false;
+  if (!isRecord$2(input)) return false;
+  for (const key of PATH_KEYS) {
+    const path = input[key];
+    if (typeof path === "string" && path.endsWith("spec.md")) return true;
+  }
+  return false;
+}
+class PhaseAccumulator {
+  constructor(kind, startedAt) {
+    this.kind = kind;
+    this.startedAt = startedAt;
+  }
+  usage = {};
+  requests = 0;
+  /** Count one API response, whether or not it reported usage. */
+  add(raw) {
+    this.requests += 1;
+    const snapshot = normalizeUsage(this.kind, raw);
+    if (!snapshot) return;
+    for (const [key, value] of Object.entries(snapshot)) {
+      const field = key;
+      this.usage[field] = (this.usage[field] ?? 0) + value;
+    }
+  }
+  snapshot() {
+    return {
+      usage: { ...this.usage },
+      requests: this.requests,
+      durationMs: Date.now() - this.startedAt
+    };
+  }
+}
 function blocksFrom(message) {
   if (!message || typeof message !== "object") return [];
   const content = message.content;
   if (typeof content === "string") return content ? [{ type: "text", text: content }] : [];
   return Array.isArray(content) ? content : [];
 }
-function toolResultText(content) {
+function toolResultText$1(content) {
   if (typeof content === "string") return content;
   if (Array.isArray(content)) {
     let acc = "";
@@ -6420,10 +6670,10 @@ function usageWindows(usage) {
   }
   return out;
 }
-function num$1(value) {
+function num$2(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
-function isRecord(value) {
+function isRecord$1(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 function withCost(usage, costUsd) {
@@ -6431,11 +6681,11 @@ function withCost(usage, costUsd) {
   return { ...usage ?? {}, costUsd };
 }
 function primaryModel(modelUsage) {
-  if (!isRecord(modelUsage)) return void 0;
+  if (!isRecord$1(modelUsage)) return void 0;
   let best;
   let bestOutput = -1;
   for (const [model, raw] of Object.entries(modelUsage)) {
-    const output = isRecord(raw) ? num$1(raw.outputTokens) ?? 0 : 0;
+    const output = isRecord$1(raw) ? num$2(raw.outputTokens) ?? 0 : 0;
     if (output > bestOutput) {
       bestOutput = output;
       best = model;
@@ -6443,38 +6693,8 @@ function primaryModel(modelUsage) {
   }
   return best;
 }
-const SPEC_WRITE_TOOLS = /* @__PURE__ */ new Set(["Write", "Edit", "MultiEdit", "NotebookEdit"]);
-function isSpecWrite(name2, input) {
-  if (typeof name2 !== "string" || !SPEC_WRITE_TOOLS.has(name2)) return false;
-  const path = isRecord(input) ? input.file_path : void 0;
-  return typeof path === "string" && path.endsWith("spec.md");
-}
 function usageOf(message) {
-  return isRecord(message) ? message.usage : void 0;
-}
-class PhaseAccumulator {
-  constructor(startedAt) {
-    this.startedAt = startedAt;
-  }
-  usage = {};
-  requests = 0;
-  /** Count one API response, whether or not it reported usage. */
-  add(raw) {
-    this.requests += 1;
-    const snapshot = normalizeUsage("claude", raw);
-    if (!snapshot) return;
-    for (const [key, value] of Object.entries(snapshot)) {
-      const field = key;
-      this.usage[field] = (this.usage[field] ?? 0) + value;
-    }
-  }
-  snapshot() {
-    return {
-      usage: { ...this.usage },
-      requests: this.requests,
-      durationMs: Date.now() - this.startedAt
-    };
-  }
+  return isRecord$1(message) ? message.usage : void 0;
 }
 class ClaudeSession {
   constructor(id, cwd, isNew) {
@@ -6499,7 +6719,7 @@ class ClaudeSession {
     };
     if (this.isNew && !this.started) options.sessionId = this.id;
     else options.resume = this.id;
-    const phase = new PhaseAccumulator(Date.now());
+    const phase = new PhaseAccumulator("claude", Date.now());
     let planPhase;
     const withPhases = (base) => ({
       ...base ?? {},
@@ -6524,26 +6744,26 @@ class ClaudeSession {
             if (b.type === "text" && typeof b.text === "string") {
               yield { type: "text", delta: b.text };
             } else if (b.type === "tool_use") {
-              if (!planPhase && isSpecWrite(b.name, b.input)) planPhase = phase.snapshot();
+              if (!planPhase && isSpecWrite("claude", b.name, b.input)) planPhase = phase.snapshot();
               yield { type: "tool-use", name: String(b.name ?? "?"), input: b.input ?? {} };
             }
           }
         } else if (m.type === "user") {
           for (const b of blocksFrom(m.message)) {
             if (b.type === "tool_result") {
-              yield { type: "tool-result", text: toolResultText(b.content) };
+              yield { type: "tool-result", text: toolResultText$1(b.content) };
             }
           }
         } else if (m.type === "result") {
           usage = m.usage;
           metrics = {
-            usage: withCost(normalizeUsage("claude", m.usage), num$1(m.total_cost_usd)),
-            modelUsage: isRecord(m.modelUsage) ? m.modelUsage : void 0,
-            numTurns: num$1(m.num_turns),
+            usage: withCost(normalizeUsage("claude", m.usage), num$2(m.total_cost_usd)),
+            modelUsage: isRecord$1(m.modelUsage) ? m.modelUsage : void 0,
+            numTurns: num$2(m.num_turns),
             stopReason: typeof m.stop_reason === "string" ? m.stop_reason : void 0,
             model: primaryModel(m.modelUsage),
-            durationMs: num$1(m.duration_ms),
-            apiDurationMs: num$1(m.duration_api_ms)
+            durationMs: num$2(m.duration_ms),
+            apiDurationMs: num$2(m.duration_api_ms)
           };
         } else if (m.type === "system" && m.subtype === "compact_boundary") {
           const meta = m.compact_metadata ?? {};
@@ -6551,9 +6771,9 @@ class ClaudeSession {
             type: "compact",
             metrics: {
               trigger: meta.trigger === "manual" || meta.trigger === "auto" ? meta.trigger : void 0,
-              preTokens: num$1(meta.pre_tokens),
-              postTokens: num$1(meta.post_tokens),
-              durationMs: num$1(meta.duration_ms)
+              preTokens: num$2(meta.pre_tokens),
+              postTokens: num$2(meta.post_tokens),
+              durationMs: num$2(meta.duration_ms)
             }
           };
         } else if (m.type === "system" && m.subtype === "session_state_changed" && m.state === "idle") {
@@ -6607,7 +6827,7 @@ class ClaudeAdapter {
         } else if (b.type === "tool_use") {
           parts.push({ type: "tool-use", name: String(b.name ?? "?"), input: b.input ?? {} });
         } else if (b.type === "tool_result") {
-          parts.push({ type: "tool-result", text: toolResultText(b.content) });
+          parts.push({ type: "tool-result", text: toolResultText$1(b.content) });
         }
       }
       if (parts.length) out.push({ role: entry.type, parts });
@@ -6705,10 +6925,10 @@ function parseCodexSessionIndex(text) {
   }
   return out;
 }
-function asRecord$1(value) {
+function asRecord(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
-function numberFrom$1(value) {
+function numberFrom(value) {
   if (typeof value === "number" && Number.isFinite(value)) return value;
   if (typeof value === "string" && value.trim()) {
     const n = Number(value);
@@ -6716,33 +6936,33 @@ function numberFrom$1(value) {
   }
   return null;
 }
-function resetFrom$1(value) {
+function resetFrom(value) {
   if (typeof value === "string" && value.trim()) {
     const n2 = Number(value);
     if (Number.isFinite(n2)) return new Date(n2 * 1e3).toISOString();
     const d = new Date(value);
     return Number.isFinite(d.getTime()) ? d.toISOString() : null;
   }
-  const n = numberFrom$1(value);
+  const n = numberFrom(value);
   return n == null ? null : new Date(n * 1e3).toISOString();
 }
 function codexWindow(key, label, value) {
-  const rec = asRecord$1(value);
+  const rec = asRecord(value);
   if (!rec) return null;
-  const utilization = numberFrom$1(rec.used_percent) ?? numberFrom$1(rec.usedPercent) ?? numberFrom$1(rec.utilization) ?? numberFrom$1(rec.percent_used);
+  const utilization = numberFrom(rec.used_percent) ?? numberFrom(rec.usedPercent) ?? numberFrom(rec.utilization) ?? numberFrom(rec.percent_used);
   if (utilization == null) return null;
   return {
     key,
     label,
     utilization,
-    resetsAt: resetFrom$1(rec.resets_at ?? rec.reset_at ?? rec.resetsAt ?? rec.resetAt)
+    resetsAt: resetFrom(rec.resets_at ?? rec.reset_at ?? rec.resetsAt ?? rec.resetAt)
   };
 }
 function parseCodexUsageResponse(raw) {
-  const root = asRecord$1(raw);
+  const root = asRecord(raw);
   if (!root) return null;
-  const rateLimit = asRecord$1(root.rate_limit);
-  const rateLimits = asRecord$1(root.rate_limits);
+  const rateLimit = asRecord(root.rate_limit);
+  const rateLimits = asRecord(root.rate_limits);
   const windows = [];
   const primary = codexWindow(
     "primary",
@@ -6759,7 +6979,7 @@ function parseCodexUsageResponse(raw) {
   const additional = root.additional_rate_limits ?? root.additionalRateLimits ?? rateLimit?.additional;
   if (Array.isArray(additional)) {
     for (const [idx, item] of additional.entries()) {
-      const rec = asRecord$1(item);
+      const rec = asRecord(item);
       const label = String(rec?.label ?? rec?.name ?? rec?.limit_name ?? `Additional ${idx + 1}`);
       const win = codexWindow(`additional:${idx}`, label, item);
       if (win) windows.push(win);
@@ -6788,8 +7008,8 @@ function parseCodexTokenCountSnapshot(text) {
     } catch {
       continue;
     }
-    const rec = asRecord$1(obj);
-    const payload = asRecord$1(rec?.payload);
+    const rec = asRecord(obj);
+    const payload = asRecord(rec?.payload);
     if (payload?.type !== "token_count") continue;
     const parsed = parseCodexUsageResponse({ rate_limits: payload.rate_limits });
     if (!parsed) continue;
@@ -6966,7 +7186,7 @@ class CodexAdapter {
     } catch {
       return null;
     }
-    const tokens = asRecord$1(asRecord$1(raw)?.tokens);
+    const tokens = asRecord(asRecord(raw)?.tokens);
     const accessToken = typeof tokens?.access_token === "string" ? tokens.access_token : "";
     const accountId = typeof tokens?.account_id === "string" ? tokens.account_id : "";
     return accessToken && accountId ? { accessToken, accountId } : null;
@@ -7065,136 +7285,6 @@ class CodexAdapter {
     return null;
   }
 }
-const OPENCODE_QUOTA_INSTALL = "npx @slkiser/opencode-quota@latest init";
-const OPENCODE_QUOTA_PLUGIN_BIN = join(
-  homedir(),
-  ".cache",
-  "opencode",
-  "packages",
-  "@slkiser",
-  "opencode-quota@latest",
-  "node_modules",
-  "@slkiser",
-  "opencode-quota",
-  "dist",
-  "bin",
-  "opencode-quota.js"
-);
-function asRecord(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
-}
-function numberFrom(value) {
-  if (typeof value === "number" && Number.isFinite(value)) return value;
-  if (typeof value === "string" && value.trim()) {
-    const n = Number(value);
-    if (Number.isFinite(n)) return n;
-  }
-  return null;
-}
-function resetFrom(value) {
-  if (typeof value === "string" && value.trim()) {
-    const n2 = Number(value);
-    if (Number.isFinite(n2)) return new Date(n2 * 1e3).toISOString();
-    const d = new Date(value);
-    return Number.isFinite(d.getTime()) ? d.toISOString() : null;
-  }
-  const n = numberFrom(value);
-  return n == null ? null : new Date(n * 1e3).toISOString();
-}
-function usageWindowFromRecord(rec, idx) {
-  const label = String(rec.label ?? rec.name ?? rec.title ?? rec.provider ?? `Window ${idx + 1}`);
-  const used = numberFrom(rec.usedPercent) ?? numberFrom(rec.used_percent) ?? numberFrom(rec.percent) ?? numberFrom(rec.utilization);
-  const remaining = numberFrom(rec.remainingPercent) ?? numberFrom(rec.remaining_percent) ?? numberFrom(rec.percentRemaining);
-  const utilization = used ?? (remaining == null ? null : 100 - remaining);
-  if (utilization == null) return null;
-  return {
-    key: String(rec.key ?? rec.id ?? label),
-    label,
-    utilization,
-    resetsAt: resetFrom(rec.resetsAt ?? rec.resets_at ?? rec.resetAt ?? rec.reset_at ?? rec.reset)
-  };
-}
-function collectOpencodeQuotaWindows(value, out, seen) {
-  if (!value || seen.has(value)) return;
-  seen.add(value);
-  if (Array.isArray(value)) {
-    for (const item of value) collectOpencodeQuotaWindows(item, out, seen);
-    return;
-  }
-  const rec = asRecord(value);
-  if (!rec) return;
-  const win = usageWindowFromRecord(rec, out.length);
-  if (win) out.push(win);
-  for (const key of ["windows", "quotas", "items", "limits", "entries"]) {
-    if (key in rec) collectOpencodeQuotaWindows(rec[key], out, seen);
-  }
-  for (const key of ["providers", "data"]) {
-    const child = asRecord(rec[key]);
-    if (child) {
-      for (const value2 of Object.values(child)) collectOpencodeQuotaWindows(value2, out, seen);
-    } else if (key in rec) {
-      collectOpencodeQuotaWindows(rec[key], out, seen);
-    }
-  }
-}
-function parseOpencodeQuotaOutput(text) {
-  let raw;
-  try {
-    raw = JSON.parse(text);
-  } catch {
-    return parseOpencodeQuotaText(text);
-  }
-  const windows = [];
-  collectOpencodeQuotaWindows(raw, windows, /* @__PURE__ */ new Set());
-  if (windows.length === 0) return null;
-  return {
-    kind: "opencode",
-    status: "available",
-    checkedAt: Date.now(),
-    source: "external-cli",
-    rateLimitsAvailable: true,
-    windows
-  };
-}
-function parseOpencodeQuotaText(text) {
-  const windows = [];
-  let provider = "";
-  for (const line of text.split("\n")) {
-    const providerMatch = line.match(/^\s*→\s*\[(.+?)]/);
-    if (providerMatch) {
-      provider = providerMatch[1].trim();
-      continue;
-    }
-    const quotaMatch = line.match(/^\s*(.+?quota)\s+.*?(\d+(?:\.\d+)?)%\s+left/i);
-    if (!quotaMatch) continue;
-    const label = [provider, quotaMatch[1].trim()].filter(Boolean).join(": ");
-    const remaining = Number(quotaMatch[2]);
-    windows.push({
-      key: label || `quota:${windows.length}`,
-      label: label || `Quota ${windows.length + 1}`,
-      utilization: Math.max(0, Math.min(100, 100 - remaining)),
-      resetsAt: null
-    });
-  }
-  if (windows.length === 0) return null;
-  return {
-    kind: "opencode",
-    status: "available",
-    checkedAt: Date.now(),
-    source: "external-cli",
-    rateLimitsAvailable: true,
-    windows
-  };
-}
-async function opencodeQuotaCommands() {
-  const commands = [{ cmd: "opencode-quota", args: ["show", "--json"] }];
-  try {
-    await access(OPENCODE_QUOTA_PLUGIN_BIN);
-    commands.push({ cmd: process.execPath, args: [OPENCODE_QUOTA_PLUGIN_BIN, "show", "--json"] });
-  } catch {
-  }
-  return commands;
-}
 function textParts(parts) {
   const out = [];
   for (const p of parts) {
@@ -7265,7 +7355,19 @@ class OpenCodeAdapter {
   booting = null;
   async ensure() {
     if (!this.booting) {
-      this.booting = createOpencode({ hostname: "127.0.0.1" }).catch((err) => {
+      this.booting = createOpencode({
+        hostname: "127.0.0.1",
+        port: 0,
+        config: {
+          permission: {
+            edit: "allow",
+            bash: "allow",
+            webfetch: "allow",
+            doom_loop: "allow",
+            external_directory: "allow"
+          }
+        }
+      }).catch((err) => {
         this.booting = null;
         throw err;
       });
@@ -7314,62 +7416,404 @@ class OpenCodeAdapter {
     }
     return out;
   }
+  /**
+   * `usageStatus: false` —— opencode 自身没有配额查询接口，早先那条路径是去调
+   * 第三方 opencode-quota 插件；实测装了也拿不到可用数据，只会在空态里留下一行
+   * 「去装插件」的噪音。与其留一个必然失败的探测（每次还要 spawn 一个 10s 超时
+   * 的子进程），不如明确声明不支持：前端据此什么都不显示。
+   */
   capabilities() {
-    return { listSessions: true, getMessages: true, usageStatus: true };
+    return { listSessions: true, getMessages: true, usageStatus: false };
   }
-  async getUsageStatus() {
-    let lastError;
-    for (const command of await opencodeQuotaCommands()) {
-      try {
-        const { stdout } = await execFileWithoutWindow(command.cmd, command.args, {
-          cwd: this.cwd,
-          encoding: "utf8",
-          timeout: 1e4,
-          maxBuffer: 1024 * 1024
-        });
-        const parsed = parseOpencodeQuotaOutput(stdout);
-        if (parsed) return parsed;
-        return {
-          kind: this.kind,
-          status: "error",
-          checkedAt: Date.now(),
-          source: "external-cli",
-          message: "opencode-quota returned no parseable quota windows"
+  async dispose() {
+    if (!this.booting) return;
+    try {
+      const { server } = await this.booting;
+      server.close();
+    } catch {
+    }
+    this.booting = null;
+  }
+}
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function num$1(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function contentText(content) {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return "";
+  let acc = "";
+  for (const c of content) {
+    if (isRecord(c) && c.type === "text" && typeof c.text === "string") acc += c.text;
+  }
+  return acc;
+}
+function toolResultText(result) {
+  if (typeof result === "string") return result;
+  if (Array.isArray(result)) return contentText(result);
+  if (isRecord(result)) {
+    const inner = contentText(result.content);
+    if (inner) return inner;
+    if (typeof result.output === "string") return result.output;
+  }
+  return result == null ? "" : JSON.stringify(result);
+}
+function addUsage(acc, raw) {
+  if (!isRecord(raw)) return;
+  for (const key of [
+    "input",
+    "output",
+    "cacheRead",
+    "cacheWrite",
+    "cacheWrite1h",
+    "reasoning",
+    "totalTokens"
+  ]) {
+    const value = num$1(raw[key]);
+    if (value === void 0) continue;
+    acc[key] = (acc[key] ?? 0) + value;
+  }
+  const cost = raw.cost;
+  if (!isRecord(cost)) return;
+  const target = acc.cost ??= {};
+  for (const key of ["input", "output", "cacheRead", "cacheWrite", "total"]) {
+    const value = num$1(cost[key]);
+    if (value === void 0) continue;
+    target[key] = (target[key] ?? 0) + value;
+  }
+}
+function hasUsage(usage) {
+  return Object.keys(usage).length > 0;
+}
+class EventQueue {
+  items = [];
+  wake = null;
+  closed = false;
+  push(item) {
+    this.items.push(item);
+    this.notify();
+  }
+  /** Stop after the already-queued items drain — never discards them. */
+  close() {
+    this.closed = true;
+    this.notify();
+  }
+  notify() {
+    const resume = this.wake;
+    this.wake = null;
+    resume?.();
+  }
+  async *drain() {
+    for (; ; ) {
+      while (this.items.length) yield this.items.shift();
+      if (this.closed) return;
+      await new Promise((resolve2) => {
+        this.wake = resolve2;
+      });
+    }
+  }
+}
+class PiSession {
+  constructor(id, cwd, isNew, adapter) {
+    this.id = id;
+    this.cwd = cwd;
+    this.isNew = isNew;
+    this.adapter = adapter;
+  }
+  started = false;
+  live = null;
+  aborted = false;
+  /**
+   * One Pi session per turn.
+   *
+   * `AgentSession` has no release hook, so a long-lived `PiAgentSession` would
+   * leak its listeners and extension runtime for as long as the chat exists.
+   * The expensive part — model catalog and auth — is hoisted into the adapter's
+   * shared `ModelRuntime`, leaving per-turn setup cheap.
+   */
+  async *send(prompt, opts) {
+    this.aborted = false;
+    if (opts?.signal) {
+      if (opts.signal.aborted) return;
+      opts.signal.addEventListener("abort", () => this.abort(), { once: true });
+    }
+    const phase = new PhaseAccumulator("pi", Date.now());
+    let planPhase;
+    const usage = {};
+    let model;
+    let stopReason;
+    let turns = 0;
+    let compactionStartedAt = 0;
+    const startedAt = Date.now();
+    let session;
+    let resumeError;
+    try {
+      const resolved = await this.openPiSession();
+      session = resolved.session;
+      resumeError = resolved.resumeError;
+    } catch (err) {
+      yield { type: "error", message: err instanceof Error ? err.message : String(err) };
+      return;
+    }
+    this.live = session;
+    if (resumeError) yield { type: "error", message: resumeError };
+    if (!this.started || session.sessionId !== this.id) {
+      this.started = true;
+      this.id = session.sessionId;
+      yield { type: "session-started", sessionId: this.id };
+    }
+    const queue = new EventQueue();
+    const unsubscribe = session.subscribe((event) => queue.push(event));
+    let promptError;
+    const running = session.prompt(prompt, { expandPromptTemplates: false }).catch((err) => {
+      promptError = err;
+    }).finally(() => queue.close());
+    try {
+      for await (const event of queue.drain()) {
+        switch (event.type) {
+          case "message_update": {
+            const delta = event.assistantMessageEvent;
+            if (delta.type === "text_delta" && delta.delta) {
+              yield { type: "text", delta: delta.delta };
+            }
+            break;
+          }
+          case "message_end": {
+            const message = event.message;
+            if (isRecord(message) && message.role === "assistant") {
+              phase.add(message.usage);
+              addUsage(usage, message.usage);
+              if (typeof message.model === "string") model = message.model;
+              if (typeof message.stopReason === "string") stopReason = message.stopReason;
+              if (message.stopReason === "error") {
+                const detail = typeof message.errorMessage === "string" && message.errorMessage ? message.errorMessage : "pi assistant turn failed";
+                yield { type: "error", message: detail };
+              }
+            }
+            break;
+          }
+          case "turn_end":
+            turns += 1;
+            break;
+          case "tool_execution_start": {
+            if (!planPhase && isSpecWrite("pi", event.toolName, event.args)) {
+              planPhase = phase.snapshot();
+            }
+            yield { type: "tool-use", name: event.toolName, input: event.args ?? {} };
+            break;
+          }
+          case "tool_execution_end": {
+            const text = toolResultText(event.result);
+            if (text) yield { type: "tool-result", text };
+            break;
+          }
+          case "compaction_start":
+            compactionStartedAt = Date.now();
+            break;
+          case "compaction_end": {
+            if (event.aborted) break;
+            if (event.errorMessage) {
+              yield { type: "error", message: event.errorMessage };
+              break;
+            }
+            yield {
+              type: "compact",
+              metrics: {
+                trigger: event.reason === "manual" ? "manual" : "auto",
+                preTokens: num$1(event.result?.tokensBefore),
+                postTokens: num$1(event.result?.estimatedTokensAfter),
+                durationMs: compactionStartedAt ? Date.now() - compactionStartedAt : void 0
+              }
+            };
+            break;
+          }
+          default:
+            break;
+        }
+      }
+      await running;
+      if (this.aborted) return;
+      if (promptError) {
+        yield {
+          type: "error",
+          message: promptError instanceof Error ? promptError.message : String(promptError)
         };
-      } catch (err2) {
-        lastError = err2;
-        if (err2.code === "ENOENT") continue;
-        break;
+        return;
       }
-    }
-    const err = lastError;
-    const code = err?.code;
-    if (code === "ENOENT") {
-      return {
-        kind: this.kind,
-        status: "unavailable",
-        checkedAt: Date.now(),
-        source: "external-cli",
-        installCommand: OPENCODE_QUOTA_INSTALL,
-        message: "opencode-quota is not installed"
+      const metrics = {
+        usage: normalizeUsage("pi", usage),
+        numTurns: turns || void 0,
+        stopReason,
+        model,
+        durationMs: Date.now() - startedAt,
+        planPhase,
+        observedTotal: phase.snapshot()
       };
+      yield { type: "turn-completed", usage: hasUsage(usage) ? usage : void 0, metrics };
+    } finally {
+      unsubscribe();
+      session.dispose();
+      this.live = null;
+      this.started = true;
     }
-    return {
+  }
+  abort() {
+    this.aborted = true;
+    void this.live?.abort();
+  }
+  /** Build (or reopen) the Pi session backing this turn. */
+  async openPiSession() {
+    let resumeError;
+    let manager;
+    if (this.isNew && !this.started) {
+      manager = SessionManager$1.create(this.cwd, this.adapter.sessionDirOption, { id: this.id });
+    } else {
+      const path = await this.adapter.resolveSessionPath(this.id);
+      if (path) {
+        manager = SessionManager$1.open(path, this.adapter.sessionDirOption, this.cwd);
+      } else {
+        resumeError = `pi session ${this.id} was not found on disk; started a new session instead`;
+        manager = SessionManager$1.create(this.cwd, this.adapter.sessionDirOption);
+      }
+    }
+    const { session } = await createAgentSession({
+      cwd: this.cwd,
+      agentDir: this.adapter.agentDirOption,
+      modelRuntime: await this.adapter.ensureRuntime(),
+      sessionManager: manager
+    });
+    return { session, resumeError };
+  }
+}
+class PiAdapter {
+  constructor(cwd, opts = {}) {
+    this.cwd = cwd;
+    this.opts = opts;
+  }
+  kind = "pi";
+  runtime = null;
+  /** `session id → JSONL path`, refreshed from disk on a miss. */
+  pathIndex = /* @__PURE__ */ new Map();
+  get agentDirOption() {
+    return this.opts.agentDir;
+  }
+  get sessionDirOption() {
+    return this.opts.sessionDir;
+  }
+  /**
+   * Lazily build one `ModelRuntime` for every session this adapter serves.
+   *
+   * Creating it reads auth and the model catalog — the dominant cost of
+   * `createAgentSession()`. On failure the memo is cleared so the next turn
+   * retries instead of replaying a cached rejection forever.
+   */
+  async ensureRuntime() {
+    if (!this.runtime) {
+      const agentDir = this.opts.agentDir;
+      this.runtime = ModelRuntime.create(
+        agentDir ? { authPath: join(agentDir, "auth.json"), modelsPath: join(agentDir, "models.json") } : void 0
+      ).catch((err) => {
+        this.runtime = null;
+        throw err;
+      });
+    }
+    return this.runtime;
+  }
+  async createSession() {
+    return new PiSession(randomUUID(), this.cwd, true, this);
+  }
+  async resumeSession(id) {
+    return new PiSession(id, this.cwd, false, this);
+  }
+  async listSessions() {
+    const infos = await this.listPiSessions();
+    return infos.map((info) => ({
+      id: info.id,
+      title: this.titleOf(info),
       kind: this.kind,
-      status: "error",
-      checkedAt: Date.now(),
-      source: "external-cli",
-      message: err instanceof Error ? err.message : String(err)
-    };
+      createdAt: info.created.getTime(),
+      updatedAt: info.modified.getTime()
+    })).sort((a, b) => b.updatedAt - a.updatedAt);
+  }
+  async getMessages(id) {
+    const path = await this.resolveSessionPath(id);
+    if (!path) return [];
+    let entries;
+    try {
+      entries = SessionManager$1.open(path, this.opts.sessionDir, this.cwd).getEntries();
+    } catch {
+      return [];
+    }
+    const out = [];
+    for (const entry of entries) {
+      if (entry.type !== "message") continue;
+      const message = entry.message;
+      if (!isRecord(message)) continue;
+      const ts = num$1(message.timestamp);
+      if (message.role === "user") {
+        const text = contentText(message.content);
+        if (text) out.push({ role: "user", parts: [{ type: "text", text }], ts });
+      } else if (message.role === "assistant") {
+        const parts = [];
+        const content = Array.isArray(message.content) ? message.content : [];
+        for (const block of content) {
+          if (!isRecord(block)) continue;
+          if (block.type === "text" && typeof block.text === "string" && block.text) {
+            parts.push({ type: "text", text: block.text });
+          } else if (block.type === "toolCall") {
+            parts.push({
+              type: "tool-use",
+              name: String(block.name ?? "?"),
+              input: block.arguments ?? {}
+            });
+          }
+        }
+        if (parts.length) out.push({ role: "assistant", parts, ts });
+      } else if (message.role === "toolResult") {
+        const text = toolResultText(message.content);
+        if (!text) continue;
+        const last = out[out.length - 1];
+        if (last?.role === "assistant") last.parts.push({ type: "tool-result", text });
+      }
+    }
+    return out;
+  }
+  /**
+   * `usageStatus: false` — Pi is BYO-provider: `ModelRuntime` knows whether auth
+   * is configured but has no quota window to report. Declaring it unsupported
+   * lets the GUI render nothing, which beats a probe that must always fail.
+   */
+  capabilities() {
+    return { listSessions: true, getMessages: true, usageStatus: false };
   }
   async dispose() {
-    if (!this.booting) return;
+    this.runtime = null;
+    this.pathIndex.clear();
+  }
+  /** Resolve a session id to its JSONL path, refreshing the index on a miss. */
+  async resolveSessionPath(id) {
+    const cached = this.pathIndex.get(id);
+    if (cached) return cached;
+    await this.listPiSessions();
+    return this.pathIndex.get(id) ?? null;
+  }
+  async listPiSessions() {
+    let infos;
     try {
-      const { server } = await this.booting;
-      server.close();
+      infos = await SessionManager$1.list(this.cwd, this.opts.sessionDir);
     } catch {
+      return [];
     }
-    this.booting = null;
+    const mine = infos.filter((info) => !info.cwd || info.cwd === this.cwd);
+    for (const info of mine) this.pathIndex.set(info.id, info.path);
+    return mine;
+  }
+  titleOf(info) {
+    if (info.name?.trim()) return info.name.trim();
+    const summarized = info.firstMessage ? summarizeCodexPromptForTitle(info.firstMessage) : "";
+    return summarized || info.id;
   }
 }
 function createAdapter(kind, cwd) {
@@ -7378,6 +7822,8 @@ function createAdapter(kind, cwd) {
       return new CodexAdapter(cwd);
     case "opencode":
       return new OpenCodeAdapter(cwd);
+    case "pi":
+      return new PiAdapter(cwd);
     case "claude":
     default:
       return new ClaudeAdapter(cwd);
@@ -7519,7 +7965,7 @@ class SessionManager {
     const indexed = await this.store.list();
     const byId = new Map(indexed.map((s) => [s.id, s]));
     const nativeIds = /* @__PURE__ */ new Set();
-    for (const kind of ["claude", "codex", "opencode"]) {
+    for (const kind of ["claude", "codex", "opencode", "pi"]) {
       const adapter = this.adapters.get(kind);
       if (!adapter.capabilities().listSessions) continue;
       try {
@@ -7958,6 +8404,22 @@ class ProjectRegistry {
     const normalized = await prepareProjectDir(absPath);
     return await addProject(normalized, this.globalConfigPath);
   }
+  /**
+   * 与 CLI `yorz add` 语义对齐的添加：含 git 仓库检查 / `git init` / `.gitignore` 写入。
+   *
+   * @param absPath 项目目录绝对路径（调用方需先归一化）。
+   * @param opts `gitInit` 为 true 时授权对非 git 目录自动执行 `git init`。
+   * @returns 注册结果。
+   * @throws {NeedGitInitError} 目标非 git 仓库且未授权 `git init`；此时无任何副作用。
+   */
+  async addWithGit(absPath, opts = {}) {
+    if (!isAbsolute(absPath)) throw new Error(`path must be absolute: ${absPath}`);
+    return await addProjectWithGit({
+      path: absPath,
+      gitInit: opts.gitInit === true,
+      ...this.globalConfigPath !== void 0 ? { globalConfigPath: this.globalConfigPath } : {}
+    });
+  }
   async remove(id) {
     await this.release(id).catch(() => {
     });
@@ -8068,7 +8530,9 @@ class ProjectRegistry {
 }
 function resolveProjectAgentKind(projectAgent, globalDefault) {
   if (projectAgent.kind === "inherit") return globalDefault;
-  if (projectAgent.kind === "codex" || projectAgent.kind === "opencode") return projectAgent.kind;
+  if (projectAgent.kind === "codex" || projectAgent.kind === "opencode" || projectAgent.kind === "pi") {
+    return projectAgent.kind;
+  }
   return "claude";
 }
 function basename(p) {
@@ -8524,17 +8988,14 @@ function startBackgroundServe(opts) {
     const entry = process.argv[1];
     if (!entry) throw new Error("Cannot resolve CLI entrypoint for background service");
     const stdio = backgroundStdio();
-    const child = spawnWithoutWindow(process.execPath, [entry, "serve", ...backgroundArgs(opts)], {
-      detached: true,
-      stdio: stdio.stdio
-    });
-    child.unref();
+    const child = spawnBackgroundWorker([entry, "serve", ...backgroundArgs(opts)], stdio.stdio);
     log().info("background service spawned", {
       pid: child.pid,
+      viaLauncher: process.platform === "win32",
       stdioFile: stdio.path,
       logFile: getLogger().filePath
     });
-    const runtime = await waitForRuntime(child.pid, START_WAIT_MS);
+    const runtime = await waitForRuntime(void 0, START_WAIT_MS);
     if (!runtime) {
       log().warn("timed out waiting for runtime.json", {
         pid: child.pid,
@@ -8543,12 +9004,13 @@ function startBackgroundServe(opts) {
     }
     const port = runtime?.port ?? opts.port ?? DEFAULT_SERVE_PORT;
     const url = runtime?.url ?? `http://localhost:${port}/`;
-    console.log(`YorZ Service started in background (pid=${child.pid ?? "unknown"}).`);
+    const servicePid = runtime?.pid ?? child.pid;
+    console.log(`YorZ Service started in background (pid=${servicePid ?? "unknown"}).`);
     console.log(`Open ${url}${runtime ? "" : ` (or the next free port if ${port} is busy).`}`);
     console.log(`Stop with: yorz serve stop`);
     return {
       background: true,
-      pid: child.pid,
+      pid: servicePid,
       url,
       port
     };
@@ -8575,6 +9037,26 @@ function restartWorkerArgs(opts) {
   args.push("--skip-skill-check");
   return args;
 }
+function resolveServeLauncherPath() {
+  return join(dirname(fileURLToPath(import.meta.url)), "serve-launcher.cjs");
+}
+function backgroundWorkerSpawnArgv(launcherPath, execPath, workerArgv) {
+  return [launcherPath, "--", execPath, ...workerArgv];
+}
+function spawnBackgroundWorker(workerArgv, stdio) {
+  if (process.platform === "win32") {
+    const launcher = spawnWithoutWindow(
+      process.execPath,
+      backgroundWorkerSpawnArgv(resolveServeLauncherPath(), process.execPath, workerArgv),
+      { detached: true, stdio }
+    );
+    launcher.unref();
+    return launcher;
+  }
+  const child = spawnWithoutWindow(process.execPath, workerArgv, { detached: true, stdio });
+  child.unref();
+  return child;
+}
 async function runRestartServe(opts = {}) {
   silenceConsoleMirror();
   if (opts.worker) {
@@ -8585,12 +9067,8 @@ async function runRestartServe(opts = {}) {
   }
   const entry = process.argv[1];
   if (!entry) throw new Error("Cannot resolve CLI entrypoint for restart");
-  const child = spawnWithoutWindow(process.execPath, [entry, ...restartWorkerArgs(opts)], {
-    detached: true,
-    stdio: "ignore"
-  });
-  child.unref();
-  console.log(`YorZ Service restart scheduled (pid=${child.pid ?? "unknown"}).`);
+  spawnBackgroundWorker([entry, ...restartWorkerArgs(opts)], "ignore");
+  console.log(`YorZ Service restart scheduled.`);
 }
 async function ensureSkillsInstalledWithLog(cwd) {
   const results = await ensureSkillsInstalled({ cwd });
@@ -8762,7 +9240,7 @@ async function waitForRuntime(pid, timeoutMs) {
   const until = Date.now() + timeoutMs;
   while (Date.now() < until) {
     const live = await readLiveProcesses();
-    const match = live.find((p) => pid === void 0 || p.pid === pid);
+    const match = live.find((p) => pid === void 0);
     if (match) return match;
     await sleep(100);
   }
@@ -8923,12 +9401,18 @@ async function readWindowsProcessSnapshot(pid) {
       "if ($null -eq $p) { exit 1 }",
       "$p | Select-Object CommandLine,CreationDate | ConvertTo-Json -Compress"
     ].join("; ");
-    const { stdout } = await execFileAsync("powershell.exe", [
-      "-NoProfile",
-      "-NonInteractive",
-      "-Command",
-      script
-    ]);
+    const { stdout } = await execFileAsync(
+      "powershell.exe",
+      [
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        script
+      ],
+      // 后台 Service 进程（detached，无控制台）内执行时，缺 windowsHide 会弹出
+      // 可见的 PowerShell 窗口；前台终端调用则继承控制台，本就无影响。
+      { windowsHide: true }
+    );
     const parsed = JSON.parse(stdout.trim());
     const commandLine = typeof parsed.CommandLine === "string" ? parsed.CommandLine : "";
     const processStartedAt = typeof parsed.CreationDate === "string" ? parsed.CreationDate : void 0;
@@ -8964,35 +9448,33 @@ async function defaultPrompt(question) {
   }
 }
 async function runAdd(opts) {
-  const abs = await prepareProjectDir(opts.path, opts.cwd);
-  const gitInit = opts.runGitInit ?? runGitInit;
-  const isTTY = opts.isTTY ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
-  let gitInitialized = false;
-  if (!await isGitRepo(abs)) {
-    if (opts.yes) {
-      await gitInit(abs);
-      gitInitialized = true;
-    } else if (isTTY) {
-      const ask = opts.prompt ?? defaultPrompt;
-      const raw = await ask(`yorz add: ${abs} 未 git init，是否自动执行 \`git init\`? [y/N] `);
-      const answer = raw.trim().toLowerCase();
-      if (answer === "y" || answer === "yes") {
-        await gitInit(abs);
-        gitInitialized = true;
-      } else {
+  const gitInit = opts.runGitInit ?? ((cwd) => runGitInit(cwd));
+  const base = {
+    path: opts.path,
+    ...opts.cwd !== void 0 ? { cwd: opts.cwd } : {},
+    ...opts.globalConfigPath !== void 0 ? { globalConfigPath: opts.globalConfigPath } : {},
+    runGitInit: gitInit
+  };
+  try {
+    return await addProjectWithGit(base);
+  } catch (err) {
+    if (!(err instanceof NeedGitInitError)) throw err;
+    const isTTY = opts.isTTY ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    if (!opts.yes) {
+      if (!isTTY) {
         throw new AddGitAbortedError(
-          `yorz add: aborted — target directory is not a git repository`
+          `yorz add: target directory is not a git repository; pass --yes to auto-run git init in non-interactive mode`
         );
       }
-    } else {
-      throw new AddGitAbortedError(
-        `yorz add: target directory is not a git repository; pass --yes to auto-run git init in non-interactive mode`
-      );
+      const ask = opts.prompt ?? defaultPrompt;
+      const raw = await ask(`yorz add: ${err.path} 未 git init，是否自动执行 \`git init\`? [y/N] `);
+      const answer = raw.trim().toLowerCase();
+      if (answer !== "y" && answer !== "yes") {
+        throw new AddGitAbortedError(`yorz add: aborted — target directory is not a git repository`);
+      }
     }
+    return await addProjectWithGit({ ...base, gitInit: true });
   }
-  const gitignore = await ensureTmpIgnored(abs);
-  const { entry, created } = await addProject(abs, opts.globalConfigPath);
-  return { entry, created, gitInitialized, gitignore };
 }
 const md = new MarkdownIt("commonmark", { html: false, linkify: false });
 function buildContext(raw, kind, filePath) {