poe-code 3.0.154 → 3.0.156

package/dist/index.js

@@ -925,16 +925,16 @@ function getConfigFormat(pathOrFormat) {
   }
   return formatRegistry[formatName];
 }
-function detectFormat(path43) {
-  const ext = getExtension(path43);
+function detectFormat(path48) {
+  const ext = getExtension(path48);
   return extensionMap[ext];
 }
-function getExtension(path43) {
-  const lastDot = path43.lastIndexOf(".");
+function getExtension(path48) {
+  const lastDot = path48.lastIndexOf(".");
   if (lastDot === -1) {
     return "";
   }
-  return path43.slice(lastDot).toLowerCase();
+  return path48.slice(lastDot).toLowerCase();
 }
 var formatRegistry, extensionMap;
 var init_formats = __esm({
@@ -1265,8 +1265,8 @@ async function applyChmod(mutation, context, options) {
     };
   }
   try {
-    const stat13 = await context.fs.stat(targetPath);
-    const currentMode = typeof stat13.mode === "number" ? stat13.mode & 511 : null;
+    const stat14 = await context.fs.stat(targetPath);
+    const currentMode = typeof stat14.mode === "number" ? stat14.mode & 511 : null;
     if (currentMode === mutation.mode) {
       return {
         outcome: { changed: false, effect: "none", detail: "noop" },
@@ -1989,38 +1989,38 @@ import { createTwoFilesPatch } from "diff";
 import chalk from "chalk";
 function createDryRunFileSystem(base, recorder) {
   const proxy = {
-    async readFile(path43, encoding) {
+    async readFile(path48, encoding) {
       if (encoding) {
-        return base.readFile(path43, encoding);
+        return base.readFile(path48, encoding);
       }
-      return base.readFile(path43);
+      return base.readFile(path48);
     },
-    async writeFile(path43, data, options) {
-      const previousContent = await tryReadText(base, path43);
+    async writeFile(path48, data, options) {
+      const previousContent = await tryReadText(base, path48);
       const nextContent = formatData(data, options?.encoding);
       recorder.record({
         type: "writeFile",
-        path: path43,
+        path: path48,
         nextContent,
         previousContent
       });
     },
-    async mkdir(path43, options) {
-      recorder.record({ type: "mkdir", path: path43, options });
+    async mkdir(path48, options) {
+      recorder.record({ type: "mkdir", path: path48, options });
     },
-    async stat(path43) {
-      return base.stat(path43);
+    async stat(path48) {
+      return base.stat(path48);
     },
-    async unlink(path43) {
-      recorder.record({ type: "unlink", path: path43 });
+    async unlink(path48) {
+      recorder.record({ type: "unlink", path: path48 });
     },
-    async readdir(path43) {
-      return base.readdir(path43);
+    async readdir(path48) {
+      return base.readdir(path48);
     }
   };
   if (typeof base.rm === "function") {
-    proxy.rm = async (path43, options) => {
-      recorder.record({ type: "rm", path: path43, options });
+    proxy.rm = async (path48, options) => {
+      recorder.record({ type: "rm", path: path48, options });
     };
   }
   if (typeof base.copyFile === "function") {
@@ -2110,8 +2110,8 @@ function describeWriteChange(previous, next) {
   }
   return "update";
 }
-function renderWriteCommand(path43, change) {
-  const command = `cat > ${path43}`;
+function renderWriteCommand(path48, change) {
+  const command = `cat > ${path48}`;
   if (change === "create") {
     return renderOperationCommand(command, chalk.green, "# create");
   }
@@ -2273,9 +2273,9 @@ function redactTomlLine(line) {
   }
   return line;
 }
-async function tryReadText(base, path43) {
+async function tryReadText(base, path48) {
   try {
-    return await base.readFile(path43, "utf8");
+    return await base.readFile(path48, "utf8");
   } catch (error2) {
     if (isNotFound(error2)) {
       return null;
@@ -2756,7 +2756,7 @@ function toTomlInlineTable(values) {
   return `{${parts.join(", ")}}`;
 }
 function serializeJsonMcpArgs(servers) {
-  return ["--mcp-servers", JSON.stringify({ mcpServers: toJsonMcpServers(servers) })];
+  return ["--mcp-config", JSON.stringify({ mcpServers: toJsonMcpServers(servers) })];
 }
 function serializeOpenCodeMcpEnv(servers) {
   const mcp = {};
@@ -3404,6 +3404,9 @@ function resolveOutputFormat(env = process.env) {
   cached = VALID_FORMATS.has(raw) ? raw : "terminal";
   return cached;
 }
+function withOutputFormat(format, fn) {
+  return formatStorage.run(format, fn);
+}
 function resetOutputFormatCache() {
   cached = void 0;
 }
@@ -7362,6 +7365,7 @@ function renderUsage(tokens) {
     );
     return;
   }
+  process.stdout.write("\n");
   writeLine(chalk8.green(`\u2713 tokens: ${tokens.input} in${cached2} \u2192 ${tokens.output} out${cost}`));
 }
 function renderError(message2) {
@@ -7751,6 +7755,14 @@ async function text3(opts) {
 async function confirm2(opts) {
   return clack.confirm(opts);
 }
+async function confirmOrCancel(opts) {
+  const result = await confirm2(opts);
+  if (Ct(result)) {
+    cancel("Operation cancelled.");
+    throw new PromptCancelledError();
+  }
+  return result === true;
+}
 async function password2(opts) {
   return clack.password(opts);
 }
@@ -7817,6 +7829,7 @@ async function withSpinner(options) {
     throw error2;
   }
 }
+var PromptCancelledError;
 var init_prompts = __esm({
   "packages/design-system/src/prompts/index.ts"() {
     "use strict";
@@ -7828,6 +7841,15 @@ var init_prompts = __esm({
     init_note();
     init_outro();
     init_spinner2();
+    PromptCancelledError = class extends Error {
+      constructor(message2 = "Operation cancelled.") {
+        super(message2);
+        this.name = "PromptCancelledError";
+        if (Error.captureStackTrace) {
+          Error.captureStackTrace(this, this.constructor);
+        }
+      }
+    };
   }
 });
 
@@ -8088,21 +8110,21 @@ async function* adaptClaude(lines) {
         if (blockType !== "tool_result") continue;
         const kind = toolKindsById.get(item.tool_use_id);
         toolKindsById.delete(item.tool_use_id);
-        let path43;
+        let path48;
         if (typeof item.content === "string") {
-          path43 = item.content;
+          path48 = item.content;
         } else {
           try {
-            path43 = JSON.stringify(item.content);
+            path48 = JSON.stringify(item.content);
           } catch {
-            path43 = String(item.content);
+            path48 = String(item.content);
           }
         }
         yield {
           event: "tool_complete",
           id: item.tool_use_id,
           kind,
-          path: path43
+          path: path48
         };
       }
     }
@@ -8225,10 +8247,10 @@ async function* adaptCodex(lines) {
         const kindFromStart = toolKindById.get(item.id);
         const kind = kindFromStart ?? (itemType === "command_execution" ? "exec" : itemType === "file_edit" ? "edit" : "other");
         const titleFromEvent = isNonEmptyString(item.path) ? item.path : itemType === "mcp_tool_call" ? `${isNonEmptyString(item.server) ? item.server : "unknown"}.${isNonEmptyString(item.tool) ? item.tool : "unknown"}` : void 0;
-        const path43 = titleFromEvent ?? toolTitleById.get(item.id) ?? "";
+        const path48 = titleFromEvent ?? toolTitleById.get(item.id) ?? "";
         toolTitleById.delete(item.id);
         toolKindById.delete(item.id);
-        yield { event: "tool_complete", id: item.id, kind, path: path43 };
+        yield { event: "tool_complete", id: item.id, kind, path: path48 };
       }
     }
   }
@@ -9132,6 +9154,10 @@ var init_acp_transport = __esm({
         this.child.stderr.on("data", (chunk) => {
           this.stderrChunks.push(String(chunk));
         });
+        this.child.stdin.on("error", (error2) => {
+          const reason = error2 instanceof Error ? error2 : new Error(String(error2));
+          this.close(reason, this.child.exitCode ?? null, this.child.signalCode ?? null);
+        });
         this.layer = new JsonRpcMessageLayer({
           input: this.child.stdout,
           output: this.child.stdin,
@@ -9236,8 +9262,8 @@ function resourceNotFound(resource) {
     `Resource not found: ${resource}`
   );
 }
-function assertAbsolutePath(path43) {
-  if (!isAbsolute(path43)) {
+function assertAbsolutePath(path48) {
+  if (!isAbsolute(path48)) {
     throw invalidParams('"path" must be an absolute path');
   }
 }
@@ -9370,19 +9396,24 @@ var init_acp_client = __esm({
         this.permissionHandler = options.handlers?.permission ?? options.permissionHandler;
         this.fsHandler = options.handlers?.fs ?? options.fsHandler;
         this.terminalHandler = options.handlers?.terminal ?? options.terminalHandler;
+        const autoApprove = options.autoApprove === true && !this.permissionHandler;
         this.transport.onRequest(
           "session/request_permission",
           async (params) => {
-            if (!this.permissionHandler) {
-              return {
-                outcome: { outcome: "cancelled" }
-              };
+            if (this.permissionHandler) {
+              const outcome = await this.permissionHandler({
+                toolCall: params.toolCall,
+                options: params.options
+              });
+              return { outcome };
             }
-            const outcome = await this.permissionHandler({
-              toolCall: params.toolCall,
-              options: params.options
-            });
-            return { outcome };
+            if (autoApprove) {
+              const allow = params.options.find((o) => o.kind === "allow_always") ?? params.options.find((o) => o.kind === "allow_once");
+              if (allow) {
+                return { outcome: { outcome: "selected", optionId: allow.optionId } };
+              }
+            }
+            return { outcome: { outcome: "cancelled" } };
           }
         );
         this.registerCapabilityHandlers(this.clientCapabilities);
@@ -10002,13 +10033,19 @@ function toToolTitle(title, locations) {
 }
 function toToolOutput(value) {
   if (typeof value === "string") return value;
-  if (value === void 0) return "";
+  if (value === void 0 || value === null) return "";
   try {
     return JSON.stringify(value);
   } catch {
     return String(value);
   }
 }
+function extractToolOutputText(update) {
+  const raw = toToolOutput(update.rawOutput);
+  if (raw) return raw;
+  if (!update.content) return "";
+  return update.content.filter((c) => c.type === "text" && c.text).map((c) => c.text).join("");
+}
 function toEventsFromSessionUpdate(notification, state) {
   const update = notification.params.update;
   if (update.sessionUpdate === "agent_message_chunk" && update.content.type === "text") {
@@ -10081,7 +10118,7 @@ function toEventsFromSessionUpdate(notification, state) {
       events.push({
         event: "tool_complete",
         kind: renderKind,
-        path: toToolOutput(update.rawOutput),
+        path: extractToolOutputText(update),
         id: update.toolCallId
       });
     }
@@ -10089,6 +10126,15 @@ function toEventsFromSessionUpdate(notification, state) {
   }
   return [];
 }
+function toAcpMcpServers(servers) {
+  if (!servers) return [];
+  return Object.entries(servers).map(([name, server]) => ({
+    name,
+    command: server.command,
+    args: server.args ?? [],
+    env: server.env ? Object.entries(server.env).map(([k2, v]) => ({ name: k2, value: v })) : []
+  }));
+}
 function createAbortError3() {
   const error2 = new Error("Agent spawn aborted");
   error2.name = "AbortError";
@@ -10119,7 +10165,8 @@ function spawnAcp(options) {
     cwd: options.cwd ?? process.cwd(),
     env,
     requestTimeoutMs: 3e5,
-    skipAuth: acpConfig.skipAuth ?? false
+    skipAuth: acpConfig.skipAuth ?? false,
+    autoApprove: (options.mode ?? "yolo") === "yolo"
   });
   let aborted = false;
   const onAbort = () => {
@@ -10134,6 +10181,7 @@ function spawnAcp(options) {
   };
   let sessionId = "";
   let assistantText = "";
+  let lastToolOutput = "";
   const eventQueue = [];
   const waiters = [];
   let eventsDone = false;
@@ -10176,7 +10224,7 @@ function spawnAcp(options) {
       if (initResult.authMethods && initResult.authMethods.length > 0 && client.state !== "ready") {
         await client.authenticate(initResult.authMethods[0].id);
       }
-      const session = await client.newSession(options.cwd ?? process.cwd(), []);
+      const session = await client.newSession(options.cwd ?? process.cwd(), toAcpMcpServers(options.mcpServers));
       sessionId = session.sessionId;
       pushEvent({ event: "session_start", threadId: sessionId });
       const turn = client.prompt(sessionId, [{ type: "text", text: options.prompt }]);
@@ -10187,6 +10235,12 @@ function spawnAcp(options) {
           assistantText += update.content.text;
         }
         for (const event of toEventsFromSessionUpdate(notification, toolState)) {
+          if (event.event === "tool_complete") {
+            const output = event.path;
+            if (output) {
+              lastToolOutput = output;
+            }
+          }
           pushEvent(event);
         }
       }
@@ -10194,8 +10248,9 @@ function spawnAcp(options) {
       const stopReason = promptResponse.stopReason;
       const meta = promptResponse._meta ?? {};
       const metaUsage = meta.usage;
+      const responseText = assistantText || lastToolOutput;
       return {
-        stdout: assistantText.length > 0 ? `${assistantText}
+        stdout: responseText.length > 0 ? `${responseText}
 ` : "",
         stderr: "",
         exitCode: stopReason === "completed" || stopReason === "end_turn" ? 0 : 1,
@@ -10320,7 +10375,7 @@ function updateSessionFromEvent(ctx, event, toolCallsById) {
   }
   const id = readString(event.id);
   const kind = readString(event.kind);
-  const path43 = readString(event.path);
+  const path48 = readString(event.path);
   let toolCall = id ? toolCallsById.get(id) : void 0;
   if (!toolCall) {
     toolCall = {};
@@ -10335,8 +10390,8 @@ function updateSessionFromEvent(ctx, event, toolCallsById) {
   if (kind) {
     toolCall.kind = kind;
   }
-  if (path43) {
-    toolCall.path = path43;
+  if (path48) {
+    toolCall.path = path48;
   }
 }
 var sessionCapture;
@@ -10611,7 +10666,26 @@ function createCheckRunner(resources) {
   };
 }
 function listIsolatedServiceIds(container) {
-  return container.registry.list().filter((provider2) => Boolean(provider2.isolatedEnv)).map((provider2) => provider2.name);
+  return listServiceNames(
+    container.registry.list().filter((provider2) => Boolean(provider2.isolatedEnv))
+  );
+}
+function listServiceNames(services) {
+  const names = [];
+  const add = (value) => {
+    const normalized = value?.trim();
+    if (!normalized || names.includes(normalized)) {
+      return;
+    }
+    names.push(normalized);
+  };
+  for (const service of services) {
+    add(service.name);
+    for (const alias of service.aliases ?? []) {
+      add(alias);
+    }
+  }
+  return names;
 }
 function resolveServiceAdapter(container, service) {
   const adapter = container.registry.get(service);
@@ -10806,14 +10880,14 @@ function parseDockerLocator(input) {
     throw new Error(`Invalid docker workspace locator "${input}".`);
   }
   const container = input.slice(0, slashIndex);
-  const path43 = input.slice(slashIndex);
-  if (container.length === 0 || path43.length === 0) {
+  const path48 = input.slice(slashIndex);
+  if (container.length === 0 || path48.length === 0) {
     throw new Error(`Invalid docker workspace locator "${input}".`);
   }
   return {
     scheme: "docker",
     container,
-    path: path43
+    path: path48
   };
 }
 function splitOnce(input, separator) {
@@ -12690,21 +12764,21 @@ function createSdkContainer(options) {
   });
   loggerFactory.setErrorLogger(errorLogger);
   const asyncFs = {
-    readFile: ((path43, encoding) => {
+    readFile: ((path48, encoding) => {
       if (encoding) {
-        return fs2.readFile(path43, encoding);
+        return fs2.readFile(path48, encoding);
       }
-      return fs2.readFile(path43);
+      return fs2.readFile(path48);
     }),
-    writeFile: (path43, data, opts) => fs2.writeFile(path43, data, opts),
-    mkdir: (path43, opts) => fs2.mkdir(path43, opts).then(() => {
+    writeFile: (path48, data, opts) => fs2.writeFile(path48, data, opts),
+    mkdir: (path48, opts) => fs2.mkdir(path48, opts).then(() => {
     }),
-    stat: (path43) => fs2.stat(path43),
-    rm: (path43, opts) => fs2.rm(path43, opts),
-    unlink: (path43) => fs2.unlink(path43),
-    readdir: (path43) => fs2.readdir(path43),
+    stat: (path48) => fs2.stat(path48),
+    rm: (path48, opts) => fs2.rm(path48, opts),
+    unlink: (path48) => fs2.unlink(path48),
+    readdir: (path48) => fs2.readdir(path48),
     copyFile: (src, dest) => fs2.copyFile(src, dest),
-    chmod: (path43, mode) => fs2.chmod(path43, mode)
+    chmod: (path48, mode) => fs2.chmod(path48, mode)
   };
   const contextFactory = createCommandContextFactory({ fs: asyncFs });
   const authFs = {
@@ -13337,11 +13411,11 @@ function createDefaultFs() {
     readFile: fsPromises2.readFile,
     readdir: fsPromises2.readdir,
     stat: async (filePath) => {
-      const stat13 = await fsPromises2.stat(filePath);
+      const stat14 = await fsPromises2.stat(filePath);
       return {
-        isFile: () => stat13.isFile(),
-        isDirectory: () => stat13.isDirectory(),
-        mtimeMs: stat13.mtimeMs
+        isFile: () => stat14.isFile(),
+        isDirectory: () => stat14.isDirectory(),
+        mtimeMs: stat14.mtimeMs
       };
     }
   };
@@ -13368,8 +13442,8 @@ function countCompletedTasks(planPath, content) {
 async function ensurePlanExists(fs3, cwd, planPath) {
   const absolutePath = path15.isAbsolute(planPath) ? planPath : path15.resolve(cwd, planPath);
   try {
-    const stat13 = await fs3.stat(absolutePath);
-    if (!stat13.isFile()) {
+    const stat14 = await fs3.stat(absolutePath);
+    if (!stat14.isFile()) {
       throw new Error(`Plan not found at "${planPath}".`);
     }
   } catch (error2) {
@@ -13395,8 +13469,8 @@ async function scanPlansDir(fs3, plansDir, displayPrefix) {
       continue;
     }
     const absolutePath = path15.join(plansDir, entry);
-    const stat13 = await fs3.stat(absolutePath);
-    if (!stat13.isFile()) {
+    const stat14 = await fs3.stat(absolutePath);
+    if (!stat14.isFile()) {
       continue;
     }
     const displayPath = path15.join(displayPrefix, entry);
@@ -13438,8 +13512,8 @@ async function resolvePlanDirectory(options) {
   const fs3 = options.fs ?? createDefaultFs();
   const projectDir = path15.join(options.cwd, ".poe-code");
   try {
-    const stat13 = await fs3.stat(projectDir);
-    if (stat13.isDirectory()) {
+    const stat14 = await fs3.stat(projectDir);
+    if (stat14.isDirectory()) {
       return path15.join(options.cwd, ".poe-code", "pipeline", "plans");
     }
   } catch {
@@ -13654,11 +13728,11 @@ function createDefaultFs2() {
     },
     rmdir: fsPromises3.rmdir,
     stat: async (filePath) => {
-      const stat13 = await fsPromises3.stat(filePath);
+      const stat14 = await fsPromises3.stat(filePath);
       return {
-        isFile: () => stat13.isFile(),
-        isDirectory: () => stat13.isDirectory(),
-        mtimeMs: stat13.mtimeMs
+        isFile: () => stat14.isFile(),
+        isDirectory: () => stat14.isDirectory(),
+        mtimeMs: stat14.mtimeMs
       };
     }
   };
@@ -13691,8 +13765,8 @@ async function lockFile(filePath, options = {}) {
       if (!error2 || typeof error2 !== "object" || !("code" in error2) || error2.code !== "EEXIST") {
         throw error2;
       }
-      const stat13 = await fs3.stat(lockPath);
-      if (Date.now() - stat13.mtimeMs > staleMs) {
+      const stat14 = await fs3.stat(lockPath);
+      if (Date.now() - stat14.mtimeMs > staleMs) {
         await fs3.rmdir(lockPath);
         continue;
       }
@@ -13718,11 +13792,11 @@ function createDefaultFs3() {
     writeFile: fsPromises4.writeFile,
     readdir: fsPromises4.readdir,
     stat: async (filePath) => {
-      const stat13 = await fsPromises4.stat(filePath);
+      const stat14 = await fsPromises4.stat(filePath);
       return {
-        isFile: () => stat13.isFile(),
-        isDirectory: () => stat13.isDirectory(),
-        mtimeMs: stat13.mtimeMs
+        isFile: () => stat14.isFile(),
+        isDirectory: () => stat14.isDirectory(),
+        mtimeMs: stat14.mtimeMs
       };
     },
     mkdir: async (filePath, options) => {
@@ -14184,8 +14258,8 @@ async function removeDirectory2(fs3, directoryPath) {
   }
   for (const entry of entries) {
     const entryPath = path18.join(directoryPath, entry);
-    const stat13 = await fs3.stat(entryPath);
-    if (stat13.isFile()) {
+    const stat14 = await fs3.stat(entryPath);
+    if (stat14.isFile()) {
       await fs3.rm(entryPath, { force: true });
       continue;
     }
@@ -14231,8 +14305,8 @@ function createStateStore(stateDir, fs3 = nodeFs2) {
     for (const entry of [...entries].sort()) {
       const entryPath = path18.join(stateDir, entry);
       try {
-        const stat13 = await fs3.stat(entryPath);
-        if (stat13.isFile()) {
+        const stat14 = await fs3.stat(entryPath);
+        if (stat14.isFile()) {
           continue;
         }
       } catch (error2) {
@@ -15638,8 +15712,8 @@ async function listIds(fs3, baseDir) {
     for (const entry of entries) {
       const entryPath = path22.join(baseDir, entry);
       try {
-        const stat13 = await fs3.stat(entryPath);
-        if (!stat13.isFile()) {
+        const stat14 = await fs3.stat(entryPath);
+        if (!stat14.isFile()) {
           ids.push(entry);
         }
       } catch (error2) {
@@ -15892,10 +15966,10 @@ function createDefaultFs4() {
   return {
     readdir: fsPromises5.readdir,
     stat: async (filePath) => {
-      const stat13 = await fsPromises5.stat(filePath);
+      const stat14 = await fsPromises5.stat(filePath);
       return {
-        isFile: () => stat13.isFile(),
-        mtimeMs: stat13.mtimeMs
+        isFile: () => stat14.isFile(),
+        mtimeMs: stat14.mtimeMs
       };
     }
   };
@@ -15922,8 +15996,8 @@ async function scanDir(fs3, absoluteDir, displayDir) {
       continue;
     }
     const absolutePath = path23.join(absoluteDir, entry);
-    const stat13 = await fs3.stat(absolutePath);
-    if (!stat13.isFile()) {
+    const stat14 = await fs3.stat(absolutePath);
+    if (!stat14.isFile()) {
       continue;
     }
     const displayPath = path23.join(displayDir, entry);
@@ -16096,10 +16170,10 @@ function createDefaultFs5() {
     writeFile: (filePath, content) => fsPromises6.writeFile(filePath, content, "utf8"),
     readdir: fsPromises6.readdir,
     stat: async (filePath) => {
-      const stat13 = await fsPromises6.stat(filePath);
+      const stat14 = await fsPromises6.stat(filePath);
       return {
-        isFile: () => stat13.isFile(),
-        mtimeMs: stat13.mtimeMs
+        isFile: () => stat14.isFile(),
+        mtimeMs: stat14.mtimeMs
       };
     },
     mkdir: async (filePath, options) => {
@@ -16626,10 +16700,10 @@ function createDefaultFs6() {
     writeFile: (filePath, content) => fsPromises7.writeFile(filePath, content, "utf8"),
     readdir: fsPromises7.readdir,
     stat: async (filePath) => {
-      const stat13 = await fsPromises7.stat(filePath);
+      const stat14 = await fsPromises7.stat(filePath);
       return {
-        isFile: () => stat13.isFile(),
-        mtimeMs: stat13.mtimeMs
+        isFile: () => stat14.isFile(),
+        mtimeMs: stat14.mtimeMs
       };
     },
     mkdir: async (filePath, options) => {
@@ -16947,10 +17021,10 @@ function createDefaultFs7() {
     },
     readdir: fsPromises8.readdir,
     stat: async (filePath) => {
-      const stat13 = await fsPromises8.stat(filePath);
+      const stat14 = await fsPromises8.stat(filePath);
       return {
-        isFile: () => stat13.isFile(),
-        mtimeMs: stat13.mtimeMs
+        isFile: () => stat14.isFile(),
+        mtimeMs: stat14.mtimeMs
       };
     },
     mkdir: async (filePath, options) => {
@@ -18564,11 +18638,11 @@ var init_commands = __esm({
       description: "Run a GitHub automation.",
       positional: ["name"],
       params: S.Object({
-        name: S.Optional(S.String()),
-        agent: S.Optional(S.String()),
-        model: S.Optional(S.String()),
-        mode: S.Optional(S.Enum(["yolo", "edit", "read"])),
-        cwd: S.Optional(S.String())
+        name: S.Optional(S.String({ description: "Automation name to run" })),
+        agent: S.Optional(S.String({ description: "Agent to run the automation with" })),
+        model: S.Optional(S.String({ description: "Model override for the agent" })),
+        mode: S.Optional(S.Enum(["yolo", "edit", "read"], { description: "Permission mode (yolo | edit | read)" })),
+        cwd: S.Optional(S.String({ description: "Working directory for the automation" }))
       }),
       secrets: {
         poeApiKey: { env: "POE_API_KEY" },
@@ -23880,11 +23954,11 @@ function formatSegment(segment, casing) {
   const separator = casing === "snake" ? "_" : "-";
   return splitWords(segment).join(separator);
 }
-function toOptionFlag(path43, casing) {
-  return `--${path43.map((segment) => formatSegment(segment, casing)).join(".")}`;
+function toOptionFlag(path48, casing) {
+  return `--${path48.map((segment) => formatSegment(segment, casing)).join(".")}`;
 }
-function toOptionAttribute(path43, casing) {
-  return path43.map((segment) => {
+function toOptionAttribute(path48, casing) {
+  return path48.map((segment) => {
     const formatted = formatSegment(segment, casing);
     if (casing === "snake") {
       return formatted;
@@ -23895,13 +23969,13 @@ function toOptionAttribute(path43, casing) {
     ).join("");
   }).join(".");
 }
-function toDisplayPath(path43) {
-  return path43.join(".");
+function toDisplayPath(path48) {
+  return path48.join(".");
 }
-function collectFields(schema, casing, path43 = [], inheritedOptional = false) {
+function collectFields(schema, casing, path48 = [], inheritedOptional = false) {
   const fields = [];
   for (const [key, rawChildSchema] of Object.entries(schema.shape)) {
-    const nextPath = [...path43, key];
+    const nextPath = [...path48, key];
     const optional = inheritedOptional || rawChildSchema.kind === "optional";
     const childSchema = unwrapOptional(rawChildSchema);
     if (childSchema.kind === "object") {
@@ -23924,9 +23998,9 @@ function collectFields(schema, casing, path43 = [], inheritedOptional = false) {
   }
   return fields;
 }
-function toCommanderOptionAttribute(path43, casing) {
-  const optionAttribute = toOptionAttribute(path43, casing);
-  const optionFlag = toOptionFlag(path43, casing);
+function toCommanderOptionAttribute(path48, casing) {
+  const optionAttribute = toOptionAttribute(path48, casing);
+  const optionFlag = toOptionFlag(path48, casing);
   if (!GLOBAL_LONG_OPTION_FLAGS.has(optionFlag)) {
     return optionAttribute;
   }
@@ -24117,8 +24191,8 @@ function findVisibleChild(group, token, scope) {
     (child) => child.name === token || child.aliases.includes(token)
   );
 }
-function resolveHelpTarget(root, argv, scope) {
-  const breadcrumb = [root.name];
+function resolveHelpTarget(root, argv, scope, rootDisplayName) {
+  const breadcrumb = [rootDisplayName ?? root.name];
   let current = root;
   for (const token of argv.slice(2)) {
     if (token.startsWith("-") || token === "help") {
@@ -24209,7 +24283,7 @@ function formatCommandRows(group, scope) {
 function formatGlobalOptionRows(showVersion) {
   const rows = [
     {
-      flags: "--preset",
+      flags: "--preset <path>",
       description: "Load parameter defaults from a JSON file"
     },
     {
@@ -24217,11 +24291,11 @@ function formatGlobalOptionRows(showVersion) {
       description: "Accept defaults, skip prompts"
     },
     {
-      flags: "--output",
+      flags: "--output <format>",
       description: "Output format (rich, md, json)"
     },
     {
-      flags: "--help",
+      flags: "-h, --help",
       description: "Show help"
     }
   ];
@@ -24236,7 +24310,14 @@ function formatGlobalOptionRows(showVersion) {
 function renderHelpSections(sections) {
   return sections.filter((section) => section.length > 0).join("\n\n");
 }
-function renderGroupHelp(group, breadcrumb, scope, showVersion) {
+function buildUsageLine(breadcrumb, rootUsageName, suffix) {
+  if (rootUsageName === void 0) {
+    return void 0;
+  }
+  const subPath = breadcrumb.slice(1).join(" ");
+  return subPath ? `${rootUsageName} ${subPath} ${suffix}` : `${rootUsageName} ${suffix}`;
+}
+function renderGroupHelp(group, breadcrumb, scope, showVersion, rootUsageName) {
   const sections = [];
   const commandRows = formatCommandRows(group, scope);
   if (commandRows.length > 0) {
@@ -24247,12 +24328,13 @@ ${formatCommandList(commandRows)}`);
 ${formatOptionList(formatGlobalOptionRows(showVersion))}`);
   return renderHelpDocument({
     breadcrumb,
+    usageLine: buildUsageLine(breadcrumb, rootUsageName, "[options] [command]"),
     description: group.description,
     requiresAuth: group.requires?.auth === true,
     sections
   });
 }
-function renderLeafHelp(command, breadcrumb, casing) {
+function renderLeafHelp(command, breadcrumb, casing, rootUsageName) {
   const sections = [];
   const fields = assignPositionals(collectFields(command.params, casing), command.positional);
   const optionRows = fields.map((field) => ({
@@ -24270,8 +24352,11 @@ ${formatOptionList(formatGlobalOptionRows(false))}`);
     sections.push(`${text.section("Secrets (via environment):")}
 ${formatOptionList(secretRows)}`);
   }
+  const positionalFields = fields.filter((f) => f.positionalIndex !== void 0);
+  const usageSuffix = positionalFields.length > 0 ? `[options] ${positionalFields.map(formatPositionalToken).join(" ")}` : "[options]";
   return renderHelpDocument({
     breadcrumb,
+    usageLine: buildUsageLine(breadcrumb, rootUsageName, usageSuffix),
     description: command.description,
     requiresAuth: command.requires?.auth === true,
     sections
@@ -24279,11 +24364,14 @@ ${formatOptionList(secretRows)}`);
 }
 function renderHelpDocument(input) {
   const lines = [text.heading(input.breadcrumb.join(" ")), ""];
+  if (input.usageLine !== void 0) {
+    lines.push(`${text.section("Usage:")} ${text.usageCommand(input.usageLine)}`, "");
+  }
   if (input.description !== void 0) {
-    lines.push(`  ${input.description}`);
+    lines.push(input.description);
   }
   if (input.requiresAuth) {
-    lines.push("  Requires: authentication");
+    lines.push("Requires: authentication");
   }
   if (input.description !== void 0 || input.requiresAuth) {
     lines.push("");
@@ -24293,11 +24381,11 @@ function renderHelpDocument(input) {
 `;
 }
 async function renderGeneratedHelp(root, argv, options) {
-  const target = resolveHelpTarget(root, argv, "cli");
+  const target = resolveHelpTarget(root, argv, "cli", options.rootDisplayName);
   const output = resolveHelpOutput(argv);
   const casing = options.casing ?? "kebab";
   await withOutputFormat2(output, async () => {
-    const rendered = target.node.kind === "group" ? renderGroupHelp(target.node, target.breadcrumb, "cli", options.version !== void 0) : renderLeafHelp(target.node, target.breadcrumb, casing);
+    const rendered = target.node.kind === "group" ? renderGroupHelp(target.node, target.breadcrumb, "cli", options.version !== void 0, options.rootUsageName) : renderLeafHelp(target.node, target.breadcrumb, casing, options.rootUsageName);
     process.stdout.write(rendered);
   });
 }
@@ -24360,10 +24448,10 @@ function addGlobalOptions(command) {
     throw new InvalidArgumentError('Invalid value for "--output". Expected one of: rich, md, json.');
   }).option("--verbose", "Print stack traces for unexpected errors.");
 }
-function setNestedValue(target, path43, value) {
+function setNestedValue(target, path48, value) {
   let cursor = target;
-  for (let index = 0; index < path43.length - 1; index += 1) {
-    const segment = path43[index] ?? "";
+  for (let index = 0; index < path48.length - 1; index += 1) {
+    const segment = path48[index] ?? "";
     const existing = cursor[segment];
     if (typeof existing === "object" && existing !== null) {
       cursor = existing;
@@ -24373,7 +24461,7 @@ function setNestedValue(target, path43, value) {
     cursor[segment] = next;
     cursor = next;
   }
-  const leaf = path43[path43.length - 1];
+  const leaf = path48[path48.length - 1];
   if (leaf !== void 0) {
     cursor[leaf] = value;
   }
@@ -24463,13 +24551,13 @@ async function withOutputFormat2(output, fn) {
 }
 function createFs() {
   return {
-    readFile: async (path43, encoding = "utf8") => readFile12(path43, { encoding }),
-    writeFile: async (path43, contents) => {
-      await writeFile7(path43, contents);
+    readFile: async (path48, encoding = "utf8") => readFile12(path48, { encoding }),
+    writeFile: async (path48, contents) => {
+      await writeFile7(path48, contents);
     },
-    exists: async (path43) => {
+    exists: async (path48) => {
       try {
-        await access2(path43);
+        await access2(path48);
         return true;
       } catch {
         return false;
@@ -24490,9 +24578,9 @@ function isPlainObject(value) {
 function hasFieldValue(value) {
   return value !== void 0;
 }
-function hasNestedField(fields, path43) {
+function hasNestedField(fields, path48) {
   return fields.some(
-    (field) => path43.length < field.path.length && path43.every((segment, index) => field.path[index] === segment)
+    (field) => path48.length < field.path.length && path48.every((segment, index) => field.path[index] === segment)
   );
 }
 function describeExpectedPresetValue(schema) {
@@ -24576,9 +24664,9 @@ async function loadPresetValues(fields, presetPath) {
   }
   const fieldByPath = new Map(fields.map((field) => [field.displayPath, field]));
   const presetValues = {};
-  function visitObject(current, path43) {
+  function visitObject(current, path48) {
     for (const [key, value] of Object.entries(current)) {
-      const nextPath = [...path43, key];
+      const nextPath = [...path48, key];
       const displayPath = toDisplayPath(nextPath);
       const field = fieldByPath.get(displayPath);
       if (field !== void 0) {
@@ -25462,9 +25550,9 @@ var init_config3 = __esm({
 
 // src/cli/commands/configure.ts
 function registerConfigureCommand(program, container) {
-  const serviceNames = container.registry.list().map((service) => service.name);
+  const serviceNames = listServiceNames(container.registry.list());
   const serviceDescription = `Agent to configure${formatServiceList(serviceNames)}`;
-  const configureCommand = program.command("configure").alias("c").description("Configure developer tooling for Poe API.").argument("[agent]", serviceDescription).option("--api-key <key>", "Poe API key").option("--model <model>", "Model identifier").option("--reasoning-effort <level>", "Reasoning effort level").action(async (service, options) => {
+  const configureCommand = program.command("configure").alias("c").description("Configure developer tooling for Poe API.").argument("[agent]", serviceDescription).option("-y, --yes", "Accept defaults, skip prompts").option("--api-key <key>", "Poe API key").option("--model <model>", "Model identifier").option("--reasoning-effort <level>", "Reasoning effort level").action(async (service, options) => {
     const resolved = await resolveServiceArgument(program, container, service, {
       action: "configure"
     });
@@ -25689,12 +25777,13 @@ var init_agent2 = __esm({
 });
 
 // src/cli/commands/spawn.ts
+import { Option as Option2 } from "commander";
 function registerSpawnCommand(program, container, options = {}) {
-  const spawnServices = container.registry.list().filter((service) => typeof service.spawn === "function" || getSpawnConfig(service.name)).map((service) => service.name);
+  const spawnServices = container.registry.list().filter((service) => typeof service.spawn === "function" || getSpawnConfig(service.name));
   const extraServices = options.extraServices ?? [];
-  const serviceList = [...spawnServices, ...extraServices];
+  const serviceList = listSpawnServiceNames(spawnServices, extraServices);
   const serviceDescription = `Agent to spawn${formatServiceList(serviceList)}`;
-  program.command("spawn").alias("s").description("Run a single prompt through a configured agent CLI.").option("--model <model>", "Model identifier override passed to the agent CLI").option("-C, --cwd <path>", "Working directory or workspace locator for the agent CLI").option("--stdin", "Read the prompt from stdin").option("-i, --interactive", "Launch the agent in interactive TUI mode").option("--mode <mode>", "Permission mode: yolo | edit | read (default: yolo)").option("--mcp-servers <json>", "MCP server config JSON: {name: {command, args?, env?}}").option("--mcp-config <json>", "[deprecated: use --mcp-servers]").option("--log-dir <path>", "Directory override for ACP JSONL spawn logs").option(
+  program.command("spawn").alias("s").description("Run a single prompt through a configured agent CLI.").option("--model <model>", "Model identifier override passed to the agent CLI").option("-C, --cwd <path>", "Working directory or workspace locator for the agent CLI").option("--stdin", "Read the prompt from stdin").option("-i, --interactive", "Launch the agent in interactive TUI mode").option("--mode <mode>", "Permission mode: yolo | edit | read (default: yolo)").option("--mcp-servers <json>", "MCP server config JSON: {name: {command, args?, env?}}").addOption(new Option2("--mcp-config <json>", "[deprecated: use --mcp-servers]").hideHelp()).option("--log-dir <path>", "Directory override for ACP JSONL spawn logs").option(
     "--activity-timeout-ms <ms>",
     "Kill the agent after N ms of inactivity",
     (value) => parsePositiveInt(value, "--activity-timeout-ms")
@@ -25887,8 +25976,6 @@ function registerSpawnCommand(program, container, options = {}) {
             const trimmedStderr = final.stderr.trim();
             if (trimmedStderr) {
               resources.logger.info(renderMarkdown(trimmedStderr).trimEnd());
-            } else {
-              resources.logger.info(`${adapter.label} spawn completed.`);
             }
           }
         }
@@ -25913,6 +26000,26 @@ Resume: ${resumeCommand}`));
     }
   });
 }
+function listSpawnServiceNames(services, extraServices) {
+  const names = [];
+  const add = (value) => {
+    const normalized = value?.trim();
+    if (!normalized || names.includes(normalized)) {
+      return;
+    }
+    names.push(normalized);
+  };
+  for (const service of services) {
+    add(service.name);
+    for (const alias of service.aliases ?? []) {
+      add(alias);
+    }
+  }
+  for (const service of extraServices) {
+    add(service);
+  }
+  return names;
+}
 async function confirmUnconfiguredService(container, service, label, flags) {
   const configuredServices = await loadConfiguredServices({
     fs: container.fs,
@@ -26283,7 +26390,7 @@ var init_login = __esm({
 
 // src/cli/commands/unconfigure.ts
 function registerUnconfigureCommand(program, container) {
-  const serviceNames = container.registry.list().map((service) => service.name);
+  const serviceNames = listServiceNames(container.registry.list());
   const serviceDescription = `Agent to unconfigure${formatServiceList(serviceNames)}`;
   return program.command("unconfigure").alias("uc").description("Remove existing Poe API tooling configuration.").argument("<agent>", serviceDescription).action(async (service, options) => {
     await executeUnconfigure(program, container, service, options);
@@ -26400,7 +26507,7 @@ var init_unconfigure = __esm({
 
 // src/cli/commands/logout.ts
 function registerLogoutCommand(program, container) {
-  program.command("logout").description("Remove all Poe API configuration.").action(async () => {
+  program.command("logout").description("Remove all configuration and credentials.").action(async () => {
     await executeLogout(program, container);
   });
 }
@@ -26456,10 +26563,13 @@ function registerAuthCommand(program, container) {
   auth.command("status").description("Show login status.").action(async () => {
     await executeStatus(program, container);
   });
-  auth.command("api_key").description("Display stored API key.").action(async () => {
+  auth.command("api-key").description("Display stored API key.").action(async () => {
+    await executeApiKey(program, container);
+  });
+  auth.command("api_key", { hidden: true }).action(async () => {
     await executeApiKey(program, container);
   });
-  auth.command("login").description("Store a Poe API key.").option("--api-key <key>", "Poe API key").action(async (options) => {
+  auth.command("login").description("Store a Poe API key for reuse across commands.").option("--api-key <key>", "Poe API key").action(async (options) => {
     await executeLogin(program, container, options);
   });
   auth.command("logout").description("Remove all configuration and credentials.").action(async () => {
@@ -26657,7 +26767,7 @@ var init_config4 = __esm({
 
 // src/cli/commands/utils.ts
 function registerUtilsCommand(program, container) {
-  const utils = program.command("utils").description("Utility commands for inspecting and managing poe-code.");
+  const utils = program.command("utils").description("Utility commands for inspecting and managing poe-code.").addHelpCommand(false);
   registerConfigCommand(utils, container);
 }
 var init_utils3 = __esm({
@@ -26669,8 +26779,8 @@ var init_utils3 = __esm({
 
 // src/cli/commands/install.ts
 function registerInstallCommand(program, container) {
-  const serviceNames = container.registry.list().filter((service) => typeof service.install === "function").map((service) => service.name);
-  const serviceDescription = `Agent to install${formatServiceList(serviceNames)}`;
+  const serviceNames = container.registry.list().filter((service) => typeof service.install === "function");
+  const serviceDescription = `Agent to install${formatServiceList(listServiceNames(serviceNames))}`;
   return program.command("install").alias("i").description("Install agent binary for a configured agent.").argument(
     "[agent]",
     serviceDescription
@@ -26722,8 +26832,8 @@ var init_install = __esm({
 
 // src/cli/commands/test.ts
 function registerTestCommand(program, container) {
-  const serviceNames = container.registry.list().filter((service) => typeof service.test === "function").map((service) => service.name);
-  const serviceDescription = `Agent to test${formatServiceList(serviceNames)}`;
+  const serviceNames = container.registry.list().filter((service) => typeof service.test === "function");
+  const serviceDescription = `Agent to test${formatServiceList(listServiceNames(serviceNames))}`;
   return program.command("test").description("Run agent health checks.").argument(
     "[agent]",
     serviceDescription
@@ -26865,7 +26975,7 @@ var init_media_download = __esm({
 // src/cli/commands/generate.ts
 import path37 from "node:path";
 function registerGenerateCommand(program, container) {
-  const generate2 = program.command("generate").alias("g").description("Generate content via Poe API").option("--model <model>", `Model identifier (default: ${DEFAULT_TEXT_MODEL})`).option(
+  const generate2 = program.command("generate").alias("g").description("Generate content via Poe API.").option("--model <model>", `Model identifier (default: ${DEFAULT_TEXT_MODEL})`).option(
     "--param <key=value>",
     "Additional parameters (repeatable)",
     collectParam,
@@ -26896,7 +27006,7 @@ function registerGenerateCommand(program, container) {
     }
     outro("");
   });
-  generate2.command("text").description(`Generate text (default model: ${DEFAULT_TEXT_MODEL})`).option("--model <model>", `Model identifier (default: ${DEFAULT_TEXT_MODEL})`).option(
+  generate2.command("text").description("Generate text content.").option("--model <model>", `Model identifier (default: ${DEFAULT_TEXT_MODEL})`).option(
     "--param <key=value>",
     "Additional parameters (repeatable)",
     collectParam,
@@ -26933,7 +27043,7 @@ function registerGenerateCommand(program, container) {
 }
 function registerMediaSubcommand(generate2, program, container, type) {
   const defaultModel = DEFAULT_MODELS2[type];
-  generate2.command(type).description(`Generate ${type} (default model: ${defaultModel})`).option("--model <model>", `Model identifier (default: ${defaultModel})`).option(
+  generate2.command(type).description(`Generate ${type} content.`).option("--model <model>", `Model identifier (default: ${defaultModel})`).option(
     "--param <key=value>",
     "Additional parameters (repeatable)",
     collectParam,
@@ -28617,14 +28727,12 @@ function buildHelpText() {
   const lines = [
     "",
     "Configuration:",
-    JSON.stringify({ [server.name]: server.config }, null, 2),
-    "",
-    formatMcpToolsDocs()
+    JSON.stringify({ [server.name]: server.config }, null, 2)
   ];
   return lines.join("\n");
 }
 function registerMcpCommand(program, container) {
-  const mcp = program.command("mcp").description("MCP server commands").addHelpText("after", buildHelpText()).allowExcessArguments().action(function() {
+  const mcp = program.command("mcp").description("MCP server commands.").addHelpText("after", buildHelpText()).allowExcessArguments().action(function() {
     if (this.args.length > 0) {
       throwCommandNotFound({
         container,
@@ -28636,13 +28744,15 @@ function registerMcpCommand(program, container) {
     }
     this.help();
   });
-  mcp.command("serve").description("Run MCP server on stdin/stdout").option(
+  mcp.command("serve").description("Run MCP server on stdin/stdout.").option(
     "--output-format <format>",
     'Preferred MCP media output format(s): "url", "base64", "markdown", or comma-separated list (default: "url"). Note: "markdown" cannot be combined with other formats.'
-  ).addHelpText("after", buildHelpText()).action(async (options) => {
+  ).addHelpText("after", `${buildHelpText()}
+
+${formatMcpToolsDocs()}`).action(async (options) => {
     await runMcpServer(container, { outputFormat: options.outputFormat });
   });
-  mcp.command("configure [agent]").description("Configure MCP client to use poe-code").option("-y, --yes", "Skip prompt, use claude-code").action(async (agentArg, options) => {
+  mcp.command("configure").description("Configure MCP client to use poe-code.").argument("[agent]", `Agent to configure (${supportedAgents.join(" | ")})`).option("-y, --yes", "Accept defaults, skip prompts").action(async (agentArg, options) => {
     const flags = resolveCommandFlags(program);
     const resources = createExecutionResources(container, flags, "mcp");
     const existingKey = await container.readApiKey();
@@ -28702,7 +28812,7 @@ function registerMcpCommand(program, container) {
     });
     resources.context.finalize();
   });
-  mcp.command("unconfigure <agent>").description("Remove poe-code from MCP client").action(async (agent2) => {
+  mcp.command("unconfigure").description("Remove poe-code from MCP client.").argument("<agent>", `Agent to unconfigure (${supportedAgents.join(" | ")})`).action(async (agent2) => {
     const flags = resolveCommandFlags(program);
     const resources = createExecutionResources(container, flags, "mcp");
     resources.logger.intro(`mcp unconfigure ${agent2}`);
@@ -28810,23 +28920,24 @@ var init_configs3 = __esm({
   }
 });
 
+// packages/agent-skill-config/src/templates/poe-generate.md
+var poe_generate_default;
+var init_poe_generate = __esm({
+  "packages/agent-skill-config/src/templates/poe-generate.md"() {
+    poe_generate_default = '---\nname: poe-generate\ndescription: \'Poe code generation skill\'\n---\n\n# poe-code generate\n\nUse `poe-code generate` to create text, images, audio, or video via the Poe API.\n\n## Text generation\n\n```bash\npoe-code generate "Write a short function that parses a JSON string safely."\n```\n\nSpecify the model/bot:\n\n```bash\n# CLI option\npoe-code generate --model "gpt-4.1" "Summarize this codebase change."\n\n# Some agent runtimes call the model selector `--bot`\npoe-code generate --bot "gpt-4.1" "Summarize this codebase change."\n```\n\n## Media generation\n\nThe CLI supports media generation as subcommands:\n\n```bash\npoe-code generate image "A 3D render of a rubber duck wearing sunglasses" --model "gpt-image-1" -o duck.png\npoe-code generate video "A cinematic timelapse of a city at night" --model "veo" -o city.mp4\npoe-code generate audio "A calm 10 second lo-fi beat" --model "audio-model" -o beat.wav\n```\n\nSome agent runtimes expose the same media types as flags. If available, these are equivalent:\n\n```bash\npoe-code generate --image "A 3D render of a rubber duck wearing sunglasses" --bot "gpt-image-1" -o duck.png\npoe-code generate --video "A cinematic timelapse of a city at night" --bot "veo" -o city.mp4\npoe-code generate --audio "A calm 10 second lo-fi beat" --bot "audio-model" -o beat.wav\n```\n\n## Tips\n\n- Use `--param key=value` to pass provider/model parameters (repeatable).\n- Use `--output <path>` (or `-o`) for media outputs.\n';
+  }
+});
+
+// packages/agent-skill-config/src/templates/terminal-pilot.md
+var terminal_pilot_default;
+var init_terminal_pilot = __esm({
+  "packages/agent-skill-config/src/templates/terminal-pilot.md"() {
+    terminal_pilot_default = "---\nname: terminal-pilot\ndescription: 'Terminal automation skill using the terminal-pilot CLI'\n---\n\n# Terminal Pilot\n\nUse the `terminal-pilot` CLI when you need to automate or inspect interactive\nCLI applications through a real PTY session.\n\n## Commands\n\n- `terminal-pilot create-session` - start a PTY-backed command\n- `terminal-pilot fill` - paste text into a session\n- `terminal-pilot type` - type character-by-character for TUIs and readline\n- `terminal-pilot press-key` - send named keys such as `Enter` or `ArrowDown`\n- `terminal-pilot wait-for` - wait for terminal output to match a pattern\n- `terminal-pilot wait-for-exit` - block until a session exits\n- `terminal-pilot read-screen` - inspect the current visible terminal screen\n- `terminal-pilot read-history` - read scrollback output\n- `terminal-pilot list-sessions` - list active sessions\n- `terminal-pilot close-session` - close a session and return its exit code\n\n## Examples\n\n```bash\nterminal-pilot --help\nterminal-pilot create-session --help\nterminal-pilot read-screen --help\n```\n\nUse JSON output when another tool or script needs to read the result:\n\n```bash\nterminal-pilot list-sessions --output json\nterminal-pilot read-screen --session s1 --output json\n```\n\n## Tips\n\n- Use `fill` for pasted text and multi-line input.\n- Use `type` when the app reacts to individual keystrokes.\n- Use `press-key` for Enter, Tab, arrow keys, Escape, and control-key chords.\n- Use `wait-for --literal` for exact string matching.\n- Default terminal size is 120x40.\n";
+  }
+});
+
 // packages/agent-skill-config/src/templates.ts
-import { readFile as readFile13 } from "node:fs/promises";
-async function getTemplates() {
-  if (templatesCache) {
-    return templatesCache;
-  }
-  const entries = await Promise.all(
-    TEMPLATE_NAMES.map(async (name) => {
-      const url = new URL(`./templates/${name}`, import.meta.url);
-      return [name, await readFile13(url, "utf8")];
-    })
-  );
-  templatesCache = Object.fromEntries(entries);
-  return templatesCache;
-}
 async function loadTemplate2(templateId) {
-  const templates = await getTemplates();
   const template = templates[templateId];
   if (!template) {
     throw new Error(`Template not found: ${templateId}`);
@@ -28836,12 +28947,16 @@ async function loadTemplate2(templateId) {
 function createTemplateLoader() {
   return loadTemplate2;
 }
-var TEMPLATE_NAMES, templatesCache;
+var templates;
 var init_templates = __esm({
   "packages/agent-skill-config/src/templates.ts"() {
     "use strict";
-    TEMPLATE_NAMES = ["poe-generate.md", "terminal-pilot.md"];
-    templatesCache = null;
+    init_poe_generate();
+    init_terminal_pilot();
+    templates = {
+      "poe-generate.md": poe_generate_default,
+      "terminal-pilot.md": terminal_pilot_default
+    };
   }
 });
 
@@ -28976,16 +29091,8 @@ var init_src22 = __esm({
 });
 
 // src/cli/commands/skill.ts
-function buildHelpText2() {
-  return [
-    "",
-    "Skill directories:",
-    "- poe-code skill configure installs skill directories for supported agents.",
-    "- poe-code skill unconfigure removes skill directories."
-  ].join("\n");
-}
 function registerSkillCommand(program, container) {
-  const skill = program.command("skill").description("Skill directory commands").addHelpText("after", buildHelpText2()).allowExcessArguments().action(function() {
+  const skill = program.command("skill").description("Skill directory commands.").allowExcessArguments().action(function() {
     if (this.args.length > 0) {
       throwCommandNotFound({
         container,
@@ -28997,14 +29104,14 @@ function registerSkillCommand(program, container) {
     }
     this.help();
   });
-  skill.command("configure [agent]").description("Install skill directories for an agent").option("--agent <name>", "Agent to configure skills for").option("--local", "Use local scope (in the current project)").option("--global", "Use global scope (in the user home directory)").action(async (agentArg, options) => {
+  skill.command("configure").description("Install skill directories for an agent.").argument("[agent]", `Agent to configure skills for (${supportedAgents2.join(" | ")})`).option("-y, --yes", "Accept defaults, skip prompts").option("--local", "Use local scope (in the current project)").option("--global", "Use global scope (in the user home directory)").action(async (agentArg, options) => {
     const flags = resolveCommandFlags(program);
     const resources = createExecutionResources(container, flags, "skill");
     if (options.local && options.global) {
       resources.logger.error("Use either --local or --global, not both.");
       return;
     }
-    let agent2 = options.agent ?? agentArg;
+    let agent2 = agentArg;
     if (!agent2) {
       if (flags.assumeYes) {
         agent2 = DEFAULT_SKILL_AGENT;
@@ -29079,14 +29186,14 @@ function registerSkillCommand(program, container) {
     });
     resources.context.finalize();
   });
-  skill.command("unconfigure [agent]").description("Remove skill directories for an agent").option("--agent <name>", "Agent to unconfigure skills for").option("--local", "Use local scope (in the current project)").option("--global", "Use global scope (in the user home directory)").option("--force", "Remove directory even if it contains files").action(async (agentArg, options) => {
+  skill.command("unconfigure").description("Remove skill directories for an agent.").argument("[agent]", `Agent to unconfigure skills for (${supportedAgents2.join(" | ")})`).option("--local", "Use local scope (in the current project)").option("--global", "Use global scope (in the user home directory)").option("--force", "Remove directory even if it contains files").action(async (agentArg, options) => {
     const flags = resolveCommandFlags(program);
     const resources = createExecutionResources(container, flags, "skill");
     if (options.local && options.global) {
       resources.logger.error("Use either --local or --global, not both.");
       return;
     }
-    let agent2 = options.agent ?? agentArg;
+    let agent2 = agentArg;
     if (!agent2) {
       const selected = await select2({
         message: "Select agent to unconfigure:",
@@ -29375,7 +29482,7 @@ function registerUsageCommand(program, container) {
   const usage = program.command("usage").alias("u").description("Check Poe API usage information.").action(async () => {
     await executeBalance(program, container);
   });
-  usage.command("balance").description("Display current point balance.").action(async () => {
+  usage.command("balance", { hidden: true }).description("Display current point balance.").action(async () => {
     await executeBalance(program, container);
   });
   usage.command("list").description("Display usage history.").option("--filter <model>", "Filter results by model name").option("--pages <count>", "Number of pages to load automatically", parseInt).action(async function() {
@@ -29862,7 +29969,7 @@ var init_models2 = __esm({
 
 // src/cli/commands/pipeline.ts
 import path40 from "node:path";
-import { readFile as readFile14, stat as stat11 } from "node:fs/promises";
+import { readFile as readFile13, stat as stat11 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 async function resolvePipelinePlanDirectory(container) {
   const configDoc = await readMergedDocument(
@@ -29932,8 +30039,8 @@ async function loadPipelineTemplates() {
       continue;
     }
     const [skillPlan, steps] = await Promise.all([
-      readFile14(path40.join(templateRoot, "SKILL_plan.md"), "utf8"),
-      readFile14(path40.join(templateRoot, "steps.yaml.hbs"), "utf8")
+      readFile13(path40.join(templateRoot, "SKILL_plan.md"), "utf8"),
+      readFile13(path40.join(templateRoot, "steps.yaml.hbs"), "utf8")
     ]);
     pipelineTemplatesCache = { skillPlan, steps };
     return pipelineTemplatesCache;
@@ -29976,8 +30083,8 @@ async function pathExists3(fs3, targetPath) {
   }
 }
 function registerPipelineCommand(program, container) {
-  const pipeline = program.command("pipeline").description("Run a fixed-step task pipeline plan.");
-  pipeline.command("run").description("Run the selected pipeline plan until completion, failure, cancellation, or cap.").option("--agent <name>", "Agent to run each pipeline step with").option("--model <model>", "Model override passed to the agent").option("--task <id>", "Run only the specified task").option("--plan <path>", "Path to the pipeline plan file").option("--max-runs <n>", "Maximum number of agent executions to perform").action(async function() {
+  const pipeline = program.command("pipeline").description("Run a fixed-step task pipeline plan.").addHelpCommand(false);
+  pipeline.command("run").description("Run the selected pipeline plan until completion, failure, cancellation, or max runs.").option("--agent <name>", "Agent to run each pipeline step with").option("--model <model>", "Model override passed to the agent").option("--task <id>", "Run only the specified task").option("--plan <path>", "Path to the pipeline plan file").option("--max-runs <n>", "Maximum number of agent executions to perform").action(async function() {
     const flags = resolveCommandFlags(program);
     const resources = createExecutionResources(
       container,
@@ -30267,12 +30374,12 @@ function registerPipelineCommand(program, container) {
         scope = selected;
       }
       resources.logger.intro(`pipeline install (${support.id}, ${scope})`);
-      const templates = await loadPipelineTemplates();
+      const templates2 = await loadPipelineTemplates();
       const skillResult = await installSkill(
         support.id,
         {
           name: "poe-code-pipeline-plan",
-          content: templates.skillPlan
+          content: templates2.skillPlan
         },
         {
           fs: container.fs,
@@ -30313,7 +30420,7 @@ function registerPipelineCommand(program, container) {
         await container.fs.mkdir(path40.dirname(pipelinePaths.stepsPath), {
           recursive: true
         });
-        await container.fs.writeFile(pipelinePaths.stepsPath, templates.steps, {
+        await container.fs.writeFile(pipelinePaths.stepsPath, templates2.steps, {
           encoding: "utf8"
         });
         resources.logger.info(
@@ -30348,8 +30455,828 @@ var init_pipeline3 = __esm({
   }
 });
 
-// src/cli/commands/ralph.ts
+// packages/plan-browser/src/format.ts
 import path41 from "node:path";
+function isPipelineTaskDone(task) {
+  if (typeof task.status === "string") {
+    return task.status === "done";
+  }
+  return Object.values(task.status).every((status) => status === "done");
+}
+function formatPipelineProgress(content) {
+  const plan = parsePlan(content);
+  const done = plan.tasks.filter((task) => isPipelineTaskDone(task)).length;
+  return `${done}/${plan.tasks.length} done`;
+}
+function formatRalphDetail(frontmatter) {
+  const parts = [];
+  if (frontmatter.agent !== void 0) {
+    parts.push(Array.isArray(frontmatter.agent) ? frontmatter.agent.join(", ") : frontmatter.agent);
+  }
+  if (frontmatter.iterations !== void 0) {
+    parts.push(`\xD7${frontmatter.iterations}`);
+  }
+  if (frontmatter.status.state !== "open" || frontmatter.status.iteration > 0) {
+    parts.push(`${frontmatter.status.state} ${frontmatter.status.iteration}`);
+  } else {
+    parts.push("open");
+  }
+  return parts.join(" \xB7 ");
+}
+function formatExperimentDetail(frontmatter, state) {
+  const parts = [];
+  if (frontmatter.agent !== void 0) {
+    parts.push(Array.isArray(frontmatter.agent) ? frontmatter.agent.join(", ") : frontmatter.agent);
+  }
+  const metrics = frontmatter.metric === void 0 ? [] : Array.isArray(frontmatter.metric) ? frontmatter.metric : [frontmatter.metric];
+  if (metrics.length > 0) {
+    const directions = Array.from(new Set(metrics.map((metric) => metric.direction)));
+    parts.push(directions.join("/"));
+  }
+  parts.push(state);
+  return parts.join(" \xB7 ");
+}
+function getLastExperimentState(journalContent) {
+  const lines = journalContent.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+  for (let index = lines.length - 1; index >= 0; index -= 1) {
+    try {
+      const parsed = JSON.parse(lines[index]);
+      if (typeof parsed.status === "string" && parsed.status.length > 0) {
+        return parsed.status;
+      }
+    } catch {
+      continue;
+    }
+  }
+  return "open";
+}
+function deriveMarkdownTitle(content, fallbackName) {
+  const heading = content.split("\n").map((line) => line.trim()).find((line) => line.startsWith("# "));
+  return heading ? heading.slice(2).trim() || fallbackName : fallbackName;
+}
+function formatPipelineTaskDetails(task) {
+  if (typeof task.status === "string") {
+    return null;
+  }
+  const entries = Object.entries(task.status).map(([name, status]) => `${name}=${status}`);
+  return entries.length > 0 ? `Step status: ${entries.join(", ")}` : null;
+}
+function formatPipelinePlanMarkdown(options) {
+  const plan = parsePlan(options.content);
+  const lines = [
+    `# ${options.title}`,
+    "",
+    `Status: ${formatPipelineProgress(options.content)}`,
+    "",
+    "## Tasks",
+    ""
+  ];
+  for (const task of plan.tasks) {
+    const mark = isPipelineTaskDone(task) ? "x" : " ";
+    lines.push(`- [${mark}] ${task.title} (\`${task.id}\`)`);
+    const detail = formatPipelineTaskDetails(task);
+    if (detail) {
+      lines.push(`  - ${detail}`);
+    }
+    for (const promptLine of task.prompt.split("\n")) {
+      lines.push(`  > ${promptLine}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n").trimEnd();
+}
+function resolveExperimentJournalPath(absolutePath) {
+  return path41.join(
+    path41.dirname(absolutePath),
+    `${path41.basename(absolutePath, path41.extname(absolutePath))}.journal.jsonl`
+  );
+}
+async function readExperimentState(fs3, absolutePath) {
+  try {
+    const content = await fs3.readFile(resolveExperimentJournalPath(absolutePath), "utf8");
+    return getLastExperimentState(content);
+  } catch {
+    return "open";
+  }
+}
+async function loadPlanPreviewMarkdown(entry, fs3) {
+  const content = await fs3.readFile(entry.absolutePath, "utf8");
+  if (entry.source === "pipeline") {
+    return formatPipelinePlanMarkdown({
+      title: entry.title,
+      content
+    });
+  }
+  return content;
+}
+async function readPlanMetadata(options) {
+  const content = await options.fs.readFile(options.absolutePath, "utf8");
+  const fallbackName = path41.basename(options.path);
+  if (options.source === "pipeline") {
+    return {
+      title: fallbackName,
+      status: formatPipelineProgress(content),
+      format: "yaml"
+    };
+  }
+  if (options.source === "ralph") {
+    const parsed2 = parseFrontmatter(content);
+    return {
+      title: deriveMarkdownTitle(parsed2.body, fallbackName),
+      status: formatRalphDetail(parsed2.data),
+      format: "markdown"
+    };
+  }
+  const parsed = parseExperimentFrontmatter(content);
+  const state = await readExperimentState(options.fs, options.absolutePath);
+  return {
+    title: deriveMarkdownTitle(parsed.body, fallbackName),
+    status: formatExperimentDetail(parsed.frontmatter, state),
+    format: "markdown"
+  };
+}
+var init_format = __esm({
+  "packages/plan-browser/src/format.ts"() {
+    "use strict";
+    init_src10();
+    init_src14();
+    init_src13();
+  }
+});
+
+// packages/plan-browser/src/discovery.ts
+import path42 from "node:path";
+import * as fsPromises10 from "node:fs/promises";
+function createDefaultFs8() {
+  return {
+    readFile: fsPromises10.readFile,
+    writeFile: fsPromises10.writeFile,
+    readdir: fsPromises10.readdir,
+    stat: async (filePath) => {
+      const stat14 = await fsPromises10.stat(filePath);
+      return {
+        isFile: () => stat14.isFile(),
+        isDirectory: () => stat14.isDirectory(),
+        mtimeMs: stat14.mtimeMs
+      };
+    },
+    mkdir: async (directoryPath, mkdirOptions) => {
+      await fsPromises10.mkdir(directoryPath, mkdirOptions);
+    },
+    rename: fsPromises10.rename,
+    unlink: fsPromises10.unlink
+  };
+}
+function isNotFound4(error2) {
+  return !!error2 && typeof error2 === "object" && "code" in error2 && error2.code === "ENOENT";
+}
+function resolveAbsoluteDirectory3(dir, cwd, homeDir) {
+  if (dir.startsWith("~/")) {
+    return path42.join(homeDir, dir.slice(2));
+  }
+  return path42.isAbsolute(dir) ? dir : path42.resolve(cwd, dir);
+}
+function resolveAbsoluteDisplayPath(displayPath, cwd, homeDir) {
+  if (displayPath.startsWith("~/")) {
+    return path42.join(homeDir, displayPath.slice(2));
+  }
+  return path42.isAbsolute(displayPath) ? displayPath : path42.resolve(cwd, displayPath);
+}
+function isPipelinePlanFile(name) {
+  const lower = name.toLowerCase();
+  return lower.startsWith("plan") && (lower.endsWith(".yaml") || lower.endsWith(".yml"));
+}
+function isMarkdownFile2(name) {
+  return name.toLowerCase().endsWith(".md");
+}
+async function resolvePlanDirectorySetting(options) {
+  const envValue = options.variables?.[options.envName]?.trim();
+  if (envValue) {
+    return envValue;
+  }
+  const document = await readMergedDocument(
+    options.fs,
+    options.configPath,
+    options.projectConfigPath
+  );
+  const configured = document[options.scope]?.plan_directory;
+  return typeof configured === "string" && configured.trim().length > 0 ? configured.trim() : void 0;
+}
+async function scanDirectory(options) {
+  let entries;
+  try {
+    entries = await options.fs.readdir(options.absoluteDir);
+  } catch (error2) {
+    if (isNotFound4(error2)) {
+      return [];
+    }
+    throw error2;
+  }
+  const plans = [];
+  for (const name of entries) {
+    if (!options.include(name)) {
+      continue;
+    }
+    const absolutePath = path42.join(options.absoluteDir, name);
+    const stat14 = await options.fs.stat(absolutePath);
+    if (!stat14.isFile()) {
+      continue;
+    }
+    const displayPath = path42.join(options.displayDir, name);
+    const metadata = await readPlanMetadata({
+      source: options.source,
+      absolutePath,
+      path: displayPath,
+      fs: options.fs
+    });
+    plans.push({
+      path: displayPath,
+      absolutePath: resolveAbsoluteDisplayPath(displayPath, options.cwd, options.homeDir),
+      source: options.source,
+      format: metadata.format,
+      title: metadata.title,
+      status: metadata.status,
+      updatedAt: stat14.mtimeMs
+    });
+  }
+  return plans;
+}
+async function discoverPipelinePlans(options) {
+  const configuredDir = await resolvePlanDirectorySetting({
+    fs: options.fs,
+    configPath: options.configPath,
+    projectConfigPath: options.projectConfigPath,
+    scope: "pipeline",
+    envName: "POE_PIPELINE_PLAN_DIRECTORY",
+    variables: options.variables
+  });
+  const targets = configuredDir ? [{
+    absoluteDir: resolveAbsoluteDirectory3(configuredDir, options.cwd, options.homeDir),
+    displayDir: configuredDir
+  }] : [
+    {
+      absoluteDir: path42.join(options.cwd, ".poe-code", "pipeline", "plans"),
+      displayDir: ".poe-code/pipeline/plans"
+    },
+    {
+      absoluteDir: path42.join(options.homeDir, ".poe-code", "pipeline", "plans"),
+      displayDir: "~/.poe-code/pipeline/plans"
+    }
+  ];
+  const plans = await Promise.all(
+    targets.map(
+      (target) => scanDirectory({
+        ...target,
+        fs: options.fs,
+        source: "pipeline",
+        include: isPipelinePlanFile,
+        cwd: options.cwd,
+        homeDir: options.homeDir
+      })
+    )
+  );
+  return plans.flat();
+}
+async function discoverExperimentPlans(options) {
+  const configuredDir = await resolvePlanDirectorySetting({
+    fs: options.fs,
+    configPath: options.configPath,
+    projectConfigPath: options.projectConfigPath,
+    scope: "experiment",
+    envName: "POE_EXPERIMENT_PLAN_DIRECTORY",
+    variables: options.variables
+  });
+  const targets = configuredDir ? [{
+    absoluteDir: resolveAbsoluteDirectory3(configuredDir, options.cwd, options.homeDir),
+    displayDir: configuredDir
+  }] : [
+    {
+      absoluteDir: path42.join(options.cwd, ".poe-code", "experiments"),
+      displayDir: ".poe-code/experiments"
+    },
+    {
+      absoluteDir: path42.join(options.homeDir, ".poe-code", "experiments"),
+      displayDir: "~/.poe-code/experiments"
+    }
+  ];
+  const plans = await Promise.all(
+    targets.map(
+      (target) => scanDirectory({
+        ...target,
+        fs: options.fs,
+        source: "experiment",
+        include: isMarkdownFile2,
+        cwd: options.cwd,
+        homeDir: options.homeDir
+      })
+    )
+  );
+  return plans.flat();
+}
+async function discoverRalphPlans(options) {
+  const configuredDir = await resolvePlanDirectorySetting({
+    fs: options.fs,
+    configPath: options.configPath,
+    projectConfigPath: options.projectConfigPath,
+    scope: "ralph",
+    envName: "POE_RALPH_PLAN_DIRECTORY",
+    variables: options.variables
+  });
+  const docs = await discoverDocs({
+    cwd: options.cwd,
+    homeDir: options.homeDir,
+    planDirectory: configuredDir,
+    fs: {
+      readdir: options.fs.readdir,
+      stat: async (filePath) => {
+        const stat14 = await options.fs.stat(filePath);
+        return {
+          isFile: () => stat14.isFile(),
+          mtimeMs: stat14.mtimeMs
+        };
+      }
+    }
+  });
+  const plans = await Promise.all(
+    docs.map(async (doc) => {
+      const absolutePath = resolveAbsoluteDisplayPath(doc.path, options.cwd, options.homeDir);
+      const stat14 = await options.fs.stat(absolutePath);
+      const metadata = await readPlanMetadata({
+        source: "ralph",
+        absolutePath,
+        path: doc.path,
+        fs: options.fs
+      });
+      return {
+        path: doc.path,
+        absolutePath,
+        source: "ralph",
+        format: metadata.format,
+        title: metadata.title,
+        status: metadata.status,
+        updatedAt: stat14.mtimeMs
+      };
+    })
+  );
+  return plans;
+}
+async function discoverAllPlans(options) {
+  const fs3 = options.fs ?? createDefaultFs8();
+  const discoverers = {
+    pipeline: () => discoverPipelinePlans({ ...options, fs: fs3 }),
+    experiment: () => discoverExperimentPlans({ ...options, fs: fs3 }),
+    ralph: () => discoverRalphPlans({ ...options, fs: fs3 })
+  };
+  const sources = options.source ? [options.source] : Object.keys(discoverers);
+  const results = (await Promise.all(sources.map((source) => discoverers[source]()))).flat();
+  const deduped = /* @__PURE__ */ new Map();
+  for (const result of results) {
+    if (!deduped.has(result.absolutePath)) {
+      deduped.set(result.absolutePath, result);
+    }
+  }
+  return [...deduped.values()].sort((left, right) => {
+    if (right.updatedAt !== left.updatedAt) {
+      return right.updatedAt - left.updatedAt;
+    }
+    return left.path.localeCompare(right.path);
+  });
+}
+var init_discovery3 = __esm({
+  "packages/plan-browser/src/discovery.ts"() {
+    "use strict";
+    init_src13();
+    init_src4();
+    init_format();
+  }
+});
+
+// packages/plan-browser/src/actions.ts
+import path43 from "node:path";
+import { spawnSync as nodeSpawnSync } from "node:child_process";
+function resolveEditor2(env = process.env) {
+  const editor = env.EDITOR?.trim() || env.VISUAL?.trim() || "vi";
+  return editor.length > 0 ? editor : "vi";
+}
+function editPlan(absolutePath, options = {}) {
+  const editor = resolveEditor2(options.env);
+  const spawnSync3 = options.spawnSync ?? nodeSpawnSync;
+  spawnSync3(editor, [absolutePath], { stdio: "inherit" });
+}
+async function archivePlan3(entry, fs3) {
+  const archiveDir = path43.join(path43.dirname(entry.absolutePath), "archive");
+  const archivedPath = path43.join(archiveDir, path43.basename(entry.absolutePath));
+  await fs3.mkdir(archiveDir, { recursive: true });
+  await fs3.rename(entry.absolutePath, archivedPath);
+  return archivedPath;
+}
+async function deletePlan(entry, fs3) {
+  await fs3.unlink(entry.absolutePath);
+}
+var init_actions = __esm({
+  "packages/plan-browser/src/actions.ts"() {
+    "use strict";
+  }
+});
+
+// packages/plan-browser/src/browser.ts
+import path44 from "node:path";
+async function runPlanBrowser(options) {
+  const renderPlanPreview = async (entry) => {
+    const markdown = await loadPlanPreviewMarkdown(entry, options.fs);
+    process.stdout.write(`${renderMarkdown(markdown).trimEnd()}
+`);
+  };
+  while (true) {
+    const plans = await discoverAllPlans({
+      cwd: options.cwd,
+      homeDir: options.homeDir,
+      configPath: options.configPath,
+      projectConfigPath: options.projectConfigPath,
+      fs: options.fs,
+      source: options.source,
+      variables: options.variables
+    });
+    if (plans.length === 0) {
+      process.stdout.write("No plans found.\n");
+      return;
+    }
+    if (options.assumeYes) {
+      const selectedPlan2 = plans[0];
+      await renderPlanPreview(selectedPlan2);
+      return;
+    }
+    const selectedPath = await select2({
+      message: "Select a plan",
+      options: plans.map((plan) => ({
+        label: text.selectLabel(path44.basename(plan.path), plan.status),
+        hint: plan.source,
+        value: plan.absolutePath
+      }))
+    });
+    if (Ct(selectedPath)) {
+      return;
+    }
+    const selectedPlan = plans.find((plan) => plan.absolutePath === selectedPath);
+    if (!selectedPlan) {
+      cancel("Plan selection cancelled.");
+      return;
+    }
+    await renderPlanPreview(selectedPlan);
+    process.stdout.write("\n");
+    const action = await select2({
+      message: "Action",
+      options: [
+        { label: "Back to list", value: "back" },
+        { label: "Edit in $EDITOR", value: "edit" },
+        { label: "Archive", value: "archive" },
+        { label: "Delete", value: "delete" }
+      ]
+    });
+    if (Ct(action) || action === "back") {
+      continue;
+    }
+    if (action === "edit") {
+      editPlan(selectedPlan.absolutePath, {
+        env: options.variables ?? process.env
+      });
+      continue;
+    }
+    if (action === "archive") {
+      try {
+        const confirmed = options.assumeYes || await confirmOrCancel({
+          message: `Archive ${path44.basename(selectedPlan.path)}?`,
+          initialValue: true
+        });
+        if (confirmed) {
+          await archivePlan3(selectedPlan, options.fs);
+        }
+      } catch (error2) {
+        if (!(error2 instanceof PromptCancelledError)) {
+          throw error2;
+        }
+      }
+      continue;
+    }
+    try {
+      const confirmed = options.assumeYes || await confirmOrCancel({
+        message: `Permanently delete ${path44.basename(selectedPlan.path)}?`,
+        initialValue: true
+      });
+      if (confirmed) {
+        await deletePlan(selectedPlan, options.fs);
+      }
+    } catch (error2) {
+      if (!(error2 instanceof PromptCancelledError)) {
+        throw error2;
+      }
+    }
+  }
+}
+var init_browser = __esm({
+  "packages/plan-browser/src/browser.ts"() {
+    "use strict";
+    init_src5();
+    init_src5();
+    init_actions();
+    init_discovery3();
+    init_format();
+  }
+});
+
+// packages/plan-browser/src/index.ts
+var init_src23 = __esm({
+  "packages/plan-browser/src/index.ts"() {
+    "use strict";
+    init_discovery3();
+    init_actions();
+    init_format();
+    init_browser();
+  }
+});
+
+// src/cli/commands/plan.ts
+import path45 from "node:path";
+function resolvePlanCommandOptions(command) {
+  const localOptions = command.opts();
+  const parentOptions = command.parent?.opts() ?? {};
+  return {
+    source: localOptions.source ?? parentOptions.source,
+    output: localOptions.output ?? parentOptions.output
+  };
+}
+function resolveOutputOption(value) {
+  if (!value || value.trim().length === 0) {
+    return "terminal";
+  }
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "json") {
+    return "json";
+  }
+  if (normalized === "md" || normalized === "markdown") {
+    return "markdown";
+  }
+  if (normalized === "terminal") {
+    return "terminal";
+  }
+  throw new ValidationError(`Invalid --output value "${value}". Expected one of: terminal, md, json.`);
+}
+function resolveSource(value) {
+  if (!value || value.trim().length === 0) {
+    return void 0;
+  }
+  if (value === "pipeline" || value === "experiment" || value === "ralph") {
+    return value;
+  }
+  throw new ValidationError(`Invalid --source value "${value}". Expected pipeline, experiment, or ralph.`);
+}
+function formatDate2(timestamp) {
+  return new Date(timestamp).toISOString().slice(0, 10);
+}
+async function discoverPlans(container, source) {
+  return discoverAllPlans({
+    cwd: container.env.cwd,
+    homeDir: container.env.homeDir,
+    configPath: container.env.configPath,
+    projectConfigPath: container.env.projectConfigPath,
+    fs: container.fs,
+    source,
+    variables: container.env.variables
+  });
+}
+async function resolveSelectedPlan(options) {
+  const providedPath = options.providedPath?.trim();
+  if (providedPath) {
+    const resolvedAbsolute = providedPath.startsWith("~/") ? path45.join(options.container.env.homeDir, providedPath.slice(2)) : path45.isAbsolute(providedPath) ? providedPath : path45.resolve(options.container.env.cwd, providedPath);
+    const matched2 = options.plans.find(
+      (plan) => plan.path === providedPath || plan.absolutePath === providedPath || plan.absolutePath === resolvedAbsolute
+    );
+    if (!matched2) {
+      throw new ValidationError(`Plan not found: ${providedPath}`);
+    }
+    return matched2;
+  }
+  if (options.plans.length === 0) {
+    throw new ValidationError("No plans found.");
+  }
+  if (options.assumeYes) {
+    return options.plans[0];
+  }
+  const selected = await select2({
+    message: options.promptMessage,
+    options: options.plans.map((plan) => ({
+      label: text.selectLabel(path45.basename(plan.path), plan.status),
+      hint: plan.source,
+      value: plan.absolutePath
+    }))
+  });
+  if (Ct(selected)) {
+    throw new ValidationError("Plan selection cancelled.");
+  }
+  const matched = options.plans.find((plan) => plan.absolutePath === selected);
+  if (!matched) {
+    throw new ValidationError("Plan selection cancelled.");
+  }
+  return matched;
+}
+function writeOutput(format, value) {
+  if (format === "terminal") {
+    process.stdout.write(value.endsWith("\n") ? value : `${value}
+`);
+    return;
+  }
+  const scopedFormat = format === "markdown" ? "markdown" : "json";
+  withOutputFormat(scopedFormat, () => {
+    process.stdout.write(value.endsWith("\n") ? value : `${value}
+`);
+  });
+}
+async function renderPlanList(container, options) {
+  const format = resolveOutputOption(options.output);
+  const source = resolveSource(options.source);
+  const plans = await discoverPlans(container, source);
+  if (format === "json") {
+    writeOutput(
+      format,
+      JSON.stringify(
+        plans.map((plan) => ({
+          source: plan.source,
+          name: path45.basename(plan.path),
+          path: plan.path,
+          detail: plan.status,
+          updated: formatDate2(plan.updatedAt)
+        })),
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const table = withOutputFormat(
+    format,
+    () => renderTable({
+      theme: getTheme(),
+      columns: [
+        { name: "source", title: "Source", alignment: "left", maxLen: 12 },
+        { name: "name", title: "Name", alignment: "left", maxLen: 32 },
+        { name: "detail", title: "Detail", alignment: "left", maxLen: 40 },
+        { name: "updated", title: "Updated", alignment: "left", maxLen: 12 }
+      ],
+      rows: plans.map((plan) => ({
+        source: plan.source,
+        name: path45.basename(plan.path),
+        detail: plan.status,
+        updated: formatDate2(plan.updatedAt)
+      }))
+    })
+  );
+  writeOutput(format, table);
+}
+async function executePlanAction(options) {
+  intro(`plan ${options.action}`);
+  const flags = resolveCommandFlags(options.program);
+  const format = resolveOutputOption(options.output);
+  const plans = await discoverPlans(options.container, resolveSource(options.source));
+  const plan = await resolveSelectedPlan({
+    container: options.container,
+    plans,
+    providedPath: options.pathArg,
+    assumeYes: flags.assumeYes,
+    promptMessage: `Select a plan to ${options.action}`
+  });
+  if (options.action === "edit") {
+    editPlan(plan.absolutePath, {
+      env: options.container.env.variables
+    });
+    writeOutput(
+      format,
+      format === "json" ? JSON.stringify({ action: "edit", path: plan.path }, null, 2) : `Edited ${plan.path}`
+    );
+    return;
+  }
+  if (!flags.assumeYes) {
+    const confirmed = await confirmOrCancel({
+      message: options.action === "archive" ? `Archive ${path45.basename(plan.path)}?` : `Permanently delete ${path45.basename(plan.path)}?`,
+      initialValue: true
+    });
+    if (!confirmed) {
+      return;
+    }
+  }
+  if (options.action === "archive") {
+    const archivedPath = await archivePlan3(
+      plan,
+      options.container.fs
+    );
+    writeOutput(
+      format,
+      format === "json" ? JSON.stringify({ action: "archive", path: plan.path, archivedPath }, null, 2) : `Archived ${plan.path}`
+    );
+    return;
+  }
+  await deletePlan(
+    plan,
+    options.container.fs
+  );
+  writeOutput(
+    format,
+    format === "json" ? JSON.stringify({ action: "delete", path: plan.path }, null, 2) : `Deleted ${plan.path}`
+  );
+}
+function registerPlanCommand(program, container) {
+  const plan = program.command("plan").description("Browse, view, and manage plans across pipeline, experiment, and Ralph.").option("--source <source>", "Filter by plan source: pipeline, experiment, or ralph").action(async function() {
+    const opts = this.opts();
+    const flags = resolveCommandFlags(this);
+    intro("plan browser");
+    await runPlanBrowser({
+      cwd: container.env.cwd,
+      homeDir: container.env.homeDir,
+      configPath: container.env.configPath,
+      projectConfigPath: container.env.projectConfigPath,
+      fs: container.fs,
+      source: resolveSource(opts.source),
+      variables: container.env.variables,
+      assumeYes: flags.assumeYes
+    });
+  });
+  plan.command("list").description("List plans across all plan systems.").option("--source <source>", "Filter by plan source: pipeline, experiment, or ralph").option("--output <format>", "Output format: terminal, md, or json").action(async function() {
+    intro("plan list");
+    await renderPlanList(container, resolvePlanCommandOptions(this));
+  });
+  plan.command("view").description("Render a single plan to the terminal.").argument("[path]", "Plan path").option("--source <source>", "Filter by plan source: pipeline, experiment, or ralph").option("--output <format>", "Output format: terminal, md, or json").action(async function(pathArg) {
+    intro("plan view");
+    const flags = resolveCommandFlags(program);
+    const options = resolvePlanCommandOptions(this);
+    const format = resolveOutputOption(options.output);
+    const plans = await discoverPlans(container, resolveSource(options.source));
+    const plan2 = await resolveSelectedPlan({
+      container,
+      plans,
+      providedPath: pathArg,
+      assumeYes: flags.assumeYes,
+      promptMessage: "Select a plan to view"
+    });
+    const markdown = await loadPlanPreviewMarkdown(plan2, container.fs);
+    if (format === "json") {
+      writeOutput(
+        format,
+        JSON.stringify(
+          {
+            source: plan2.source,
+            path: plan2.path,
+            title: plan2.title,
+            detail: plan2.status,
+            content: markdown
+          },
+          null,
+          2
+        )
+      );
+      return;
+    }
+    const output = format === "markdown" ? markdown : renderMarkdown(markdown);
+    writeOutput(format, output.trimEnd());
+  });
+  plan.command("edit").description("Open a plan in $EDITOR.").argument("[path]", "Plan path").option("--source <source>", "Filter by plan source: pipeline, experiment, or ralph").option("--output <format>", "Output format: terminal, md, or json").action(async function(pathArg) {
+    await executePlanAction({
+      program,
+      container,
+      action: "edit",
+      pathArg,
+      ...resolvePlanCommandOptions(this)
+    });
+  });
+  plan.command("archive").description("Move a plan into archive/.").argument("[path]", "Plan path").option("--source <source>", "Filter by plan source: pipeline, experiment, or ralph").option("--output <format>", "Output format: terminal, md, or json").action(async function(pathArg) {
+    await executePlanAction({
+      program,
+      container,
+      action: "archive",
+      pathArg,
+      ...resolvePlanCommandOptions(this)
+    });
+  });
+  plan.command("delete").description("Delete a plan file.").argument("[path]", "Plan path").option("--source <source>", "Filter by plan source: pipeline, experiment, or ralph").option("--output <format>", "Output format: terminal, md, or json").action(async function(pathArg) {
+    await executePlanAction({
+      program,
+      container,
+      action: "delete",
+      pathArg,
+      ...resolvePlanCommandOptions(this)
+    });
+  });
+}
+var init_plan = __esm({
+  "src/cli/commands/plan.ts"() {
+    "use strict";
+    init_src5();
+    init_src23();
+    init_errors();
+    init_shared();
+  }
+});
+
+// src/cli/commands/ralph.ts
+import path46 from "node:path";
 function formatDuration2(ms) {
   const totalSeconds = Math.round(ms / 1e3);
   const minutes = Math.floor(totalSeconds / 60);
@@ -30385,9 +31312,9 @@ function normalizeConfiguredIterations(value) {
 }
 function resolveAbsoluteDocPath4(container, docPath) {
   if (docPath.startsWith("~/")) {
-    return path41.join(container.env.homeDir, docPath.slice(2));
+    return path46.join(container.env.homeDir, docPath.slice(2));
   }
-  return path41.isAbsolute(docPath) ? docPath : path41.resolve(container.env.cwd, docPath);
+  return path46.isAbsolute(docPath) ? docPath : path46.resolve(container.env.cwd, docPath);
 }
 async function resolvePlanDirectory2(container) {
   const configDoc = await readMergedDocument(
@@ -30607,7 +31534,7 @@ function expandAgentList(agent2, iterations) {
   return Array.from({ length: count }, (_2, index) => agent2[index % agent2.length]);
 }
 function registerRalphCommand(program, container) {
-  const ralph = program.command("ralph").description("Run a simple iterative markdown loop.");
+  const ralph = program.command("ralph").description("Run a simple iterative markdown loop.").addHelpCommand(false);
   ralph.command("init").description("Write Ralph config into an existing markdown doc frontmatter.").argument("[doc]", "Markdown doc path").option("--agent <name>", "Agent to write into frontmatter").option("--iterations <n>", "Number of iterations to write into frontmatter").action(async function(docArg) {
     const flags = resolveCommandFlags(program);
     const resources = createExecutionResources(container, flags, "ralph:init");
@@ -30758,11 +31685,11 @@ var init_ralph3 = __esm({
 });
 
 // src/cli/commands/experiment.ts
-import path42 from "node:path";
-import { readFile as readFile15, stat as stat12 } from "node:fs/promises";
+import path47 from "node:path";
+import { readFile as readFile15, stat as stat13 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath8 } from "node:url";
 function resolveExperimentPaths(scope, cwd, homeDir) {
-  const rootPath = scope === "global" ? path42.join(homeDir, ".poe-code", "experiments") : path42.join(cwd, ".poe-code", "experiments");
+  const rootPath = scope === "global" ? path47.join(homeDir, ".poe-code", "experiments") : path47.join(cwd, ".poe-code", "experiments");
   const displayRoot = scope === "global" ? "~/.poe-code/experiments" : ".poe-code/experiments";
   return {
     experimentsPath: rootPath,
@@ -30771,7 +31698,7 @@ function resolveExperimentPaths(scope, cwd, homeDir) {
 }
 async function pathExistsOnDisk2(targetPath) {
   try {
-    await stat12(targetPath);
+    await stat13(targetPath);
     return true;
   } catch (error2) {
     if (error2 && typeof error2 === "object" && "code" in error2 && error2.code === "ENOENT") {
@@ -30781,12 +31708,12 @@ async function pathExistsOnDisk2(targetPath) {
   }
 }
 async function findPackageRoot2(entryFilePath) {
-  let currentPath = path42.dirname(entryFilePath);
+  let currentPath = path47.dirname(entryFilePath);
   while (true) {
-    if (await pathExistsOnDisk2(path42.join(currentPath, "package.json"))) {
+    if (await pathExistsOnDisk2(path47.join(currentPath, "package.json"))) {
       return currentPath;
     }
-    const parentPath = path42.dirname(currentPath);
+    const parentPath = path47.dirname(currentPath);
     if (parentPath === currentPath) {
       throw new Error("Unable to locate package root for Experiment templates.");
     }
@@ -30799,16 +31726,16 @@ async function loadExperimentTemplates() {
   }
   const packageRoot = await findPackageRoot2(fileURLToPath8(import.meta.url));
   const templateRoots = [
-    path42.join(packageRoot, "src", "templates", "experiment"),
-    path42.join(packageRoot, "dist", "templates", "experiment")
+    path47.join(packageRoot, "src", "templates", "experiment"),
+    path47.join(packageRoot, "dist", "templates", "experiment")
   ];
   for (const templateRoot of templateRoots) {
     if (!await pathExistsOnDisk2(templateRoot)) {
       continue;
     }
     const [skillPlan, runYaml] = await Promise.all([
-      readFile15(path42.join(templateRoot, "SKILL_experiment.md"), "utf8"),
-      readFile15(path42.join(templateRoot, "run.yaml.hbs"), "utf8")
+      readFile15(path47.join(templateRoot, "SKILL_experiment.md"), "utf8"),
+      readFile15(path47.join(templateRoot, "run.yaml.hbs"), "utf8")
     ]);
     experimentTemplatesCache = { skillPlan, runYaml };
     return experimentTemplatesCache;
@@ -30895,15 +31822,15 @@ async function resolveExperimentPlanDirectory(container) {
 }
 function resolveAbsoluteDocPath5(container, docPath) {
   if (docPath.startsWith("~/")) {
-    return path42.join(container.env.homeDir, docPath.slice(2));
+    return path47.join(container.env.homeDir, docPath.slice(2));
   }
-  return path42.isAbsolute(docPath) ? docPath : path42.resolve(container.env.cwd, docPath);
+  return path47.isAbsolute(docPath) ? docPath : path47.resolve(container.env.cwd, docPath);
 }
-function resolveAbsoluteDirectory3(dir, cwd, homeDir) {
+function resolveAbsoluteDirectory4(dir, cwd, homeDir) {
   if (dir.startsWith("~/")) {
-    return path42.join(homeDir, dir.slice(2));
+    return path47.join(homeDir, dir.slice(2));
   }
-  return path42.isAbsolute(dir) ? dir : path42.resolve(cwd, dir);
+  return path47.isAbsolute(dir) ? dir : path47.resolve(cwd, dir);
 }
 async function scanExperimentDir(container, absoluteDir, displayDir) {
   let names;
@@ -30920,12 +31847,12 @@ async function scanExperimentDir(container, absoluteDir, displayDir) {
     if (!name.endsWith(".md")) {
       continue;
     }
-    const absolutePath = path42.join(absoluteDir, name);
+    const absolutePath = path47.join(absoluteDir, name);
     const fileStat = await container.fs.stat(absolutePath);
     if (!fileStat.isFile()) {
       continue;
     }
-    const displayPath = path42.join(displayDir, name);
+    const displayPath = path47.join(displayDir, name);
     docs.push({ path: displayPath, displayPath });
   }
   return docs;
@@ -30933,12 +31860,12 @@ async function scanExperimentDir(container, absoluteDir, displayDir) {
 async function discoverExperimentDocs(container, planDirectory) {
   const customDir = planDirectory?.trim();
   if (customDir) {
-    const absoluteDir = resolveAbsoluteDirectory3(customDir, container.env.cwd, container.env.homeDir);
+    const absoluteDir = resolveAbsoluteDirectory4(customDir, container.env.cwd, container.env.homeDir);
     return scanExperimentDir(container, absoluteDir, customDir);
   }
   return scanExperimentDir(
     container,
-    path42.join(container.env.cwd, EXPERIMENTS_DIRECTORY),
+    path47.join(container.env.cwd, EXPERIMENTS_DIRECTORY),
     EXPERIMENTS_DIRECTORY
   );
 }
@@ -31029,7 +31956,7 @@ function formatJournalOutput(output) {
   return trimmed.split("\n").join(" \u21B5 ");
 }
 function registerExperimentCommand(program, container) {
-  const experiment = program.command("experiment").description("Run autonomous experiment loop workflows.");
+  const experiment = program.command("experiment").description("Run autonomous experiment loop workflows.").addHelpCommand(false);
   experiment.command("run").description("Run an experiment doc through the autonomous experiment loop.").argument("[doc]", "Experiment doc path").option("--agent <agent>", "Override the agent from frontmatter").option("--max-experiments <n>", "Limit the number of experiments to run").action(async function(docArg) {
     const flags = resolveCommandFlags(program);
     const resources = createExecutionResources(container, flags, "experiment:run");
@@ -31315,12 +32242,12 @@ function registerExperimentCommand(program, container) {
         scope = selected;
       }
       resources.logger.intro(`experiment install (${support.id}, ${scope})`);
-      const templates = await loadExperimentTemplates();
+      const templates2 = await loadExperimentTemplates();
       const skillResult = await installSkill(
         support.id,
         {
           name: "poe-code-experiment-plan",
-          content: templates.skillPlan
+          content: templates2.skillPlan
         },
         {
           fs: container.fs,
@@ -31354,13 +32281,13 @@ function registerExperimentCommand(program, container) {
           );
         }
       }
-      const runYamlPath = path42.join(experimentPaths.experimentsPath, "run.yaml");
-      const runYamlDisplayPath = path42.join(experimentPaths.displayExperimentsPath, "run.yaml");
+      const runYamlPath = path47.join(experimentPaths.experimentsPath, "run.yaml");
+      const runYamlDisplayPath = path47.join(experimentPaths.displayExperimentsPath, "run.yaml");
       if (!await pathExists4(container.fs, runYamlPath)) {
         if (flags.dryRun) {
           resources.logger.dryRun(`Would create: ${runYamlDisplayPath}`);
         } else {
-          await container.fs.writeFile(runYamlPath, templates.runYaml);
+          await container.fs.writeFile(runYamlPath, templates2.runYaml);
           resources.logger.info(`Create: ${runYamlDisplayPath}`);
         }
       }
@@ -31389,16 +32316,16 @@ var init_experiment2 = __esm({
     init_src4();
     DEFAULT_EXPERIMENT_AGENT = "claude-code";
     DEFAULT_EXPERIMENT_SCOPE = "local";
-    EXPERIMENTS_DIRECTORY = path42.join(".poe-code", "experiments");
+    EXPERIMENTS_DIRECTORY = path47.join(".poe-code", "experiments");
     experimentTemplatesCache = null;
   }
 });
 
 // src/cli/commands/launch.ts
-import { Option as Option2 } from "commander";
+import { Option as Option3 } from "commander";
 function registerLaunchCommand(program, container) {
-  const launch = program.command("launch").description("Manage long-running host and Docker processes.");
-  launch.command("start [id] [commandArgs...]").usage("<id> -- <command> [args...]").description("Start and supervise a managed process.").addOption(createChoiceOption("--restart <policy>", "Restart policy", ["never", "on-failure", "always"], "on-failure")).option("--max-restarts <n>", "Max consecutive restarts", "5").option("--ready-pattern <string>", "Log substring to wait for before reporting running").option("--ready-port <port>", "TCP port to probe for readiness").option("--cwd <dir>", "Working directory for the managed process").option("--env <entry>", "Environment variable (KEY=VALUE)", collectValues, []).option("--image <image>", "Docker image").option("--mount <src:target[:ro]>", "Docker bind mount", collectValues, []).option("--port <host:container>", "Docker port mapping", collectValues, []).option("--network <name>", "Docker network").addOption(createChoiceOption("--engine <engine>", "Container engine", ["docker", "podman"])).action(async function(id, commandArgs) {
+  const launch = program.command("launch").description("Manage long-running host and Docker processes.").addHelpCommand(false);
+  launch.command("start").usage("<id> -- <command> [args...]").description("Start and supervise a managed process.").argument("[id]", "Managed process identifier").argument("[command...]", "Command and arguments to run after --").addOption(createChoiceOption("--restart <policy>", "Restart policy", ["never", "on-failure", "always"], "on-failure")).option("--max-restarts <n>", "Max consecutive restarts", "5").option("--ready-pattern <string>", "Log substring to wait for before reporting running").option("--ready-port <port>", "TCP port to probe for readiness").option("--cwd <dir>", "Working directory for the managed process").option("--env <entry>", "Environment variable (KEY=VALUE)", collectValues, []).option("--image <image>", "Docker image").option("--mount <src:target[:ro]>", "Docker bind mount", collectValues, []).option("--port <host:container>", "Docker port mapping", collectValues, []).option("--network <name>", "Docker network").addOption(createChoiceOption("--engine <engine>", "Container engine", ["docker", "podman"])).action(async function(id, commandArgs) {
     const spec = await resolveStartSpec({
       commandArgs,
       id,
@@ -31414,7 +32341,7 @@ function registerLaunchCommand(program, container) {
       spec
     });
   });
-  launch.command("stop <id>").description("Stop a managed process.").option("--force", "Stop immediately with SIGKILL / docker kill").action(async function(id) {
+  launch.command("stop").description("Stop a managed process.").argument("<id>", "Managed process identifier").option("--force", "Stop immediately with SIGKILL / docker kill").action(async function(id) {
     const result = await stopLaunch({
       force: Boolean(this.opts().force),
       homeDir: container.env.homeDir,
@@ -31424,7 +32351,7 @@ function registerLaunchCommand(program, container) {
       throw new ValidationError(`Managed process not found: ${id}`);
     }
   });
-  launch.command("restart <id>").description("Restart a managed process.").action(async function(id) {
+  launch.command("restart").description("Restart a managed process.").argument("<id>", "Managed process identifier").action(async function(id) {
     await restartLaunch({ homeDir: container.env.homeDir, id });
   });
   launch.command("status").description("List managed processes.").action(async function() {
@@ -31449,7 +32376,7 @@ function registerLaunchCommand(program, container) {
       theme: getTheme()
     }));
   });
-  launch.command("logs <id>").description("Show managed process logs.").option("--follow", "Follow log output").option("--lines <n>", "Number of lines to show", "50").option("--stderr", "Show stderr instead of stdout").action(async function(id) {
+  launch.command("logs").description("Show managed process logs.").argument("<id>", "Managed process identifier").option("--follow", "Follow log output").option("--lines <n>", "Number of lines to show", "50").option("--stderr", "Show stderr instead of stdout").action(async function(id) {
     const options = this.opts();
     const lines = parseNonNegativeInt2(options.lines, "lines") ?? 50;
     const stream = options.stderr ? "stderr" : "stdout";
@@ -31488,10 +32415,10 @@ function registerLaunchCommand(program, container) {
       process.removeListener("SIGTERM", stop);
     }
   });
-  launch.command("rm <id>").description("Remove managed process state and logs.").action(async function(id) {
+  launch.command("rm").description("Remove managed process state and logs.").argument("<id>", "Managed process identifier").action(async function(id) {
     await removeLaunch({ homeDir: container.env.homeDir, id });
   });
-  launch.command("__run <id>", { hidden: true }).action(async function(id) {
+  launch.command("__run", { hidden: true }).argument("<id>", "Managed process identifier").action(async function(id) {
     await runLaunchDaemon({ homeDir: container.env.homeDir, id });
   });
   return launch;
@@ -31769,7 +32696,7 @@ function formatUptime(state) {
   return `${seconds}s`;
 }
 function createChoiceOption(flags, description, choices, defaultValue) {
-  const option = new Option2(flags, description).choices(choices);
+  const option = new Option3(flags, description).choices(choices);
   if (defaultValue !== void 0) {
     option.default(defaultValue);
   }
@@ -31821,7 +32748,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "poe-code",
-      version: "3.0.154",
+      version: "3.0.156",
       description: "CLI tool to configure Poe API for developer workflows.",
       type: "module",
       main: "./dist/index.js",
@@ -31836,7 +32763,7 @@ var init_package = __esm({
         "codegen:check:python-types": "tsx scripts/generate-agent-spawn-py-types.ts --check",
         "install:py-poe-spawn": "pip install -e packages/py-poe-spawn",
         predev: "turbo run build --output-logs=none --log-prefix=none --verbosity=0 > /dev/null 2>&1",
-        dev: "tsx src/index.ts",
+        dev: "tsx --import ./scripts/register-hbs-loader.mjs src/index.ts",
         start: "node dist/bin.cjs",
         "dev:bundle": "npm run build && node dist/bin.cjs",
         test: "turbo run test:unit",
@@ -31929,6 +32856,7 @@ var init_package = __esm({
         "@poe-code/e2e-docker-test-runner": "*",
         "@poe-code/experiment-loop": "*",
         "@poe-code/github-workflows": "*",
+        "@poe-code/plan-browser": "*",
         "@poe-code/pipeline": "*",
         "@poe-code/poe-acp-client": "*",
         "@poe-code/poe-agent": "*",
@@ -31996,181 +32924,106 @@ function formatCommandHeader(cmd) {
   }
   return `Poe - ${parts.reverse().join(" ")}`;
 }
-function formatHelpText(input) {
-  const commandRows = [
-    {
-      name: "install",
-      aliases: ["i"],
-      args: "[agent]",
-      description: "Install agent binary for a configured agent"
-    },
-    {
-      name: "configure",
-      aliases: ["c"],
-      args: "[agent]",
-      description: "Configure a coding agent"
-    },
-    {
-      name: "unconfigure",
-      aliases: ["uc"],
-      args: "<agent>",
-      description: "Remove a previously applied configuration"
-    },
-    {
-      name: "login",
-      aliases: [],
-      args: "",
-      description: "Store a Poe API key"
-    },
-    {
-      name: "logout",
-      aliases: [],
-      args: "",
-      description: "Remove all configuration"
-    },
-    {
-      name: "auth status",
-      aliases: [],
-      args: "",
-      description: "Show login status"
-    },
-    {
-      name: "agent",
-      aliases: [],
-      args: "<prompt>",
-      description: "Run a one-shot Poe agent prompt"
-    },
-    {
-      name: "spawn",
-      aliases: ["s"],
-      args: "<agent> [prompt]",
-      description: "Launch a coding agent"
-    },
-    {
-      name: "wrap",
-      aliases: ["w"],
-      args: "<agent> [agentArgs...]",
-      description: "Run an agent with Poe isolated configuration"
-    },
-    {
-      name: "generate",
-      aliases: ["g"],
-      args: "[type]",
-      description: "Call Poe models via CLI (text/image/video/audio)"
-    },
-    {
-      name: "models",
-      aliases: ["m"],
-      args: "",
-      description: "List available Poe API models"
-    },
-    {
-      name: "mcp configure",
-      aliases: [],
-      args: "[agent]",
-      description: "Configure Poe MCP for your coding agent"
-    },
-    {
-      name: "mcp unconfigure",
-      aliases: [],
-      args: "<agent>",
-      description: "Remove Poe MCP configuration from your agent"
-    },
-    {
-      name: "experiment install",
-      aliases: [],
-      args: "[agent]",
-      description: "Install the experiment skill into agent configuration"
-    },
-    {
-      name: "skill configure",
-      aliases: [],
-      args: "[agent]",
-      description: "Configure agent skills to call Poe models"
-    },
-    {
-      name: "skill unconfigure",
-      aliases: [],
-      args: "[agent]",
-      description: "Remove agent skills configuration"
-    },
-    {
-      name: "pipeline install",
-      aliases: [],
-      args: "[agent]",
-      description: "Install pipeline skill into agent configuration"
-    },
-    {
-      name: "pipeline run",
-      aliases: [],
-      args: "",
-      description: "Run a fixed-step task pipeline plan"
-    },
-    {
-      name: "ralph init",
-      aliases: [],
-      args: "[doc]",
-      description: "Write Ralph config into a markdown doc frontmatter"
-    },
-    {
-      name: "ralph run",
-      aliases: [],
-      args: "[doc]",
-      description: "Run a markdown doc through repeated agent iterations"
-    },
-    {
-      name: "experiment run",
-      aliases: [],
-      args: "[doc]",
-      description: "Run an experiment doc through the autonomous experiment loop"
-    },
-    {
-      name: "experiment journal",
-      aliases: [],
-      args: "[doc]",
-      description: "Display an experiment journal as a formatted table"
-    },
-    {
-      name: "launch",
-      aliases: [],
-      args: "",
-      description: "Manage long-running host and Docker processes"
-    },
-    {
-      name: "github-workflows",
-      aliases: ["gh"],
-      args: "[automation]",
-      description: "GitHub workflow automations"
-    },
-    {
-      name: "usage",
-      aliases: ["u"],
-      args: "",
-      description: "Display current Poe compute points balance"
-    },
-    {
-      name: "usage list",
-      aliases: [],
-      args: "",
-      description: "Display usage history"
-    },
-    {
-      name: "utils config",
-      aliases: [],
-      args: "",
-      description: "Show config file paths and usage hints"
+function findCommandByPath(root, path48) {
+  let current = root;
+  for (const segment of path48) {
+    const next = current.commands.find(
+      (command) => Reflect.get(command, "_hidden") !== true && command.name() === segment
+    );
+    if (!next) {
+      throw new Error(`Root help command is missing: ${path48.join(" ")}`);
     }
-  ];
+    current = next;
+  }
+  return current;
+}
+function formatRootHelpCommandName(path48, command) {
+  const leaf = [command.name(), ...command.aliases()].join(", ");
+  return path48.length > 1 ? [...path48.slice(0, -1), leaf].join(" ") : leaf;
+}
+function splitUsageParts(usage) {
+  return usage.split(" ").map((part) => part.trim()).filter((part) => part.length > 0);
+}
+function formatUsage2(usage, excludedParts) {
+  return splitUsageParts(usage).filter((part) => !excludedParts.includes(part)).join(" ");
+}
+function formatRootHelpCommandArgs(command) {
+  return formatUsage2(command.usage(), ["[options]", "[command]"]);
+}
+function buildRootHelpRows(root) {
+  return ROOT_HELP_COMMAND_SPECS.map((spec) => {
+    const command = findCommandByPath(root, spec.path);
+    return {
+      name: formatRootHelpCommandName(spec.path, command),
+      args: spec.args ?? formatRootHelpCommandArgs(command),
+      description: command.description()
+    };
+  });
+}
+function formatCanonicalCommandPath(cmd) {
+  const parts = [];
+  let current = cmd;
+  while (current) {
+    const name = current.name();
+    if (name.length > 0) {
+      parts.push(name);
+    }
+    if (name === "poe-code") {
+      break;
+    }
+    current = current.parent ?? null;
+  }
+  return parts.reverse().join(" ");
+}
+function formatCanonicalCommandUsage(cmd) {
+  const usage = formatUsage2(cmd.usage(), ["[command]"]);
+  const commandPath = formatCanonicalCommandPath(cmd);
+  return usage.length > 0 ? `${commandPath} ${usage}` : commandPath;
+}
+function formatHelpItem(input) {
+  const itemIndent = 2;
+  const spacerWidth = 2;
+  const indent = " ".repeat(itemIndent);
+  if (!input.description) {
+    return `${indent}${input.term}`;
+  }
+  const paddedTerm = input.term.padEnd(
+    input.termWidth + input.term.length - input.helper.displayWidth(input.term)
+  );
+  const remainingWidth = (input.helper.helpWidth ?? 80) - input.termWidth - spacerWidth - itemIndent;
+  const descriptionIndent = `${indent}${" ".repeat(spacerWidth)}`;
+  if (remainingWidth < input.helper.minWidthToWrap) {
+    const descriptionWidth = Math.max(1, (input.helper.helpWidth ?? 80) - itemIndent - spacerWidth);
+    const formattedDescription2 = input.helper.preformatted(input.description) ? input.description : input.helper.boxWrap(input.description, descriptionWidth);
+    return `${indent}${input.term}
+${descriptionIndent}${formattedDescription2.replace(/\n/g, `
+${descriptionIndent}`)}`;
+  }
+  let formattedDescription = input.description;
+  if (!input.helper.preformatted(input.description)) {
+    formattedDescription = input.helper.boxWrap(input.description, remainingWidth).replace(/\n/g, `
+${" ".repeat(input.termWidth + spacerWidth)}`);
+  }
+  return `${indent}${paddedTerm}${" ".repeat(spacerWidth)}${formattedDescription.replace(/\n/g, `
+${indent}`)}`;
+}
+function formatHelpText(input) {
+  const commandRows = buildRootHelpRows(input.command);
   const nameWidth = Math.max(
     0,
-    ...commandRows.map((row) => [row.name, ...row.aliases].join(", ").length)
+    ...commandRows.map((row) => row.name.length)
   );
   const argsWidth = Math.max(0, ...commandRows.map((row) => row.args.length));
+  const termWidth = nameWidth + 1 + argsWidth;
   const cmd = (row) => {
-    const displayName = [row.name, ...row.aliases].join(", ");
-    const name = text.command(displayName.padEnd(nameWidth));
+    const name = text.command(row.name.padEnd(nameWidth));
     const args = row.args.length > 0 ? text.argument(row.args.padEnd(argsWidth)) : " ".repeat(argsWidth);
-    return `  ${name} ${args}  ${row.description}`;
+    return formatHelpItem({
+      term: `${name} ${args}`,
+      termWidth,
+      description: row.description,
+      helper: input.helper
+    });
   };
   return [
     text.heading(input.heading),
@@ -32190,23 +33043,16 @@ function formatHelpText(input) {
 }
 function formatSubcommandHelp(cmd, helper) {
   const termWidth = helper.padWidth(cmd, helper);
-  const itemIndentWidth = 2;
-  const itemSeparatorWidth = 2;
-  const padWidth = termWidth + itemSeparatorWidth;
-  const indent = " ".repeat(itemIndentWidth);
-  const formatItem = (term, description, style) => {
-    const padding = " ".repeat(Math.max(0, padWidth - term.length));
-    const styledTerm = `${style(term)}${padding}`;
-    if (!description) {
-      return style(term);
-    }
-    return `${styledTerm}${description}`;
-  };
-  const indentBlock = (value) => value.split("\n").map((line) => `${indent}${line}`).join("\n");
-  const formatList = (items) => items.map(indentBlock).join("\n");
+  const formatItem = (term, description, style) => formatHelpItem({
+    term: style(term),
+    termWidth,
+    description,
+    helper
+  });
+  const formatList = (items) => items.join("\n");
   const output = [];
   output.push(text.heading(formatCommandHeader(cmd)), "");
-  output.push(`${text.section("Usage:")} ${text.usageCommand(helper.commandUsage(cmd))}`, "");
+  output.push(`${text.section("Usage:")} ${text.usageCommand(formatCanonicalCommandUsage(cmd))}`, "");
   const commandDescription = helper.commandDescription(cmd);
   if (commandDescription.length > 0) {
     output.push(commandDescription, "");
@@ -32289,7 +33135,7 @@ function bootstrapProgram(container) {
   program.name("poe-code").description("Configure Poe API integrations for local developer tooling.").option("-y, --yes", "Accept defaults without prompting.").option("--dry-run", "Simulate commands without writing changes.").option("--verbose", "Show verbose logs.").helpOption("-h, --help", "Display help for command").showHelpAfterError(false).showSuggestionAfterError(true).configureHelp({
     formatHelp: (cmd, helper) => {
       if (cmd.name() === "poe-code") {
-        return formatHelpText({ heading, usageCommand, helpCommand });
+        return formatHelpText({ command: cmd, heading, usageCommand, helpCommand, helper });
       }
       return formatSubcommandHelp(cmd, helper);
     }
@@ -32310,6 +33156,7 @@ function bootstrapProgram(container) {
   registerMcpCommand(program, container);
   registerSkillCommand(program, container);
   registerPipelineCommand(program, container);
+  registerPlanCommand(program, container);
   registerRalphCommand(program, container);
   registerExperimentCommand(program, container);
   registerLaunchCommand(program, container);
@@ -32317,7 +33164,7 @@ function bootstrapProgram(container) {
     const originalArgv = [...process.argv];
     process.argv = buildCmdkitArgv(originalArgv, ghGroup);
     try {
-      await runCLI(ghGroup);
+      await runCLI(ghGroup, { rootDisplayName: `Poe - ${ghGroup.name}`, rootUsageName: `${usageCommand} ${ghGroup.name}` });
     } finally {
       process.argv = originalArgv;
     }
@@ -32356,7 +33203,7 @@ function suppressCommanderOutput(command) {
     suppressCommanderOutput(child);
   }
 }
-var FORWARDABLE_CMDKIT_FLAGS;
+var ROOT_HELP_COMMAND_SPECS, FORWARDABLE_CMDKIT_FLAGS;
 var init_program = __esm({
   async "src/cli/program.ts"() {
     "use strict";
@@ -32382,12 +33229,46 @@ var init_program = __esm({
     init_usage();
     init_models2();
     await init_pipeline3();
+    init_plan();
     await init_ralph3();
     await init_experiment2();
     init_launch2();
     init_package();
     init_command_not_found();
     init_execution_context();
+    ROOT_HELP_COMMAND_SPECS = [
+      { path: ["install"] },
+      { path: ["configure"] },
+      { path: ["unconfigure"] },
+      { path: ["login"] },
+      { path: ["logout"] },
+      { path: ["auth"] },
+      { path: ["agent"] },
+      { path: ["spawn"] },
+      { path: ["wrap"] },
+      { path: ["test"] },
+      { path: ["generate"] },
+      { path: ["models"] },
+      { path: ["mcp", "configure"] },
+      { path: ["mcp", "unconfigure"] },
+      { path: ["skill", "configure"] },
+      { path: ["skill", "unconfigure"] },
+      { path: ["pipeline", "install"] },
+      { path: ["pipeline", "run"] },
+      { path: ["pipeline", "validate"] },
+      { path: ["plan"] },
+      { path: ["experiment", "install"] },
+      { path: ["experiment", "run"] },
+      { path: ["experiment", "journal"] },
+      { path: ["experiment", "validate"] },
+      { path: ["ralph", "init"] },
+      { path: ["ralph", "run"] },
+      { path: ["launch"] },
+      { path: ["github-workflows"], args: "[automation]" },
+      { path: ["usage"] },
+      { path: ["usage", "list"] },
+      { path: ["utils", "config"] }
+    ];
     FORWARDABLE_CMDKIT_FLAGS = /* @__PURE__ */ new Set(["-y", "--yes", "--verbose"]);
   }
 });