poe-code 3.0.153 → 3.0.155

package/dist/index.js

@@ -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 = {};
@@ -7362,6 +7362,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) {
@@ -9132,6 +9133,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,
@@ -9370,19 +9375,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 +10012,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 +10097,7 @@ function toEventsFromSessionUpdate(notification, state) {
       events.push({
         event: "tool_complete",
         kind: renderKind,
-        path: toToolOutput(update.rawOutput),
+        path: extractToolOutputText(update),
         id: update.toolCallId
       });
     }
@@ -10089,6 +10105,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 +10144,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 +10160,7 @@ function spawnAcp(options) {
   };
   let sessionId = "";
   let assistantText = "";
+  let lastToolOutput = "";
   const eventQueue = [];
   const waiters = [];
   let eventsDone = false;
@@ -10176,7 +10203,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 +10214,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 +10227,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,
@@ -10611,7 +10645,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);
@@ -18564,11 +18617,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" },
@@ -24117,8 +24170,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 +24262,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 +24270,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 +24289,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 +24307,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 +24331,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 +24343,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 +24360,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);
   });
 }
@@ -25462,9 +25529,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 +25756,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 +25955,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 +25979,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 +26369,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 +26486,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 +26542,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("login").description("Store a Poe API key.").option("--api-key <key>", "Poe API key").action(async (options) => {
+  auth.command("api_key", { hidden: true }).action(async () => {
+    await executeApiKey(program, container);
+  });
+  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 +26746,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 +26758,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 +26811,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 +26954,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 +26985,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 +27022,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 +28706,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 +28723,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 +28791,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}`);
@@ -28976,16 +29065,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 +29078,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 +29160,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 +29456,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() {
@@ -29976,8 +30057,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,
@@ -30607,7 +30688,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");
@@ -31029,7 +31110,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");
@@ -31395,10 +31476,10 @@ var init_experiment2 = __esm({
 });
 
 // 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 +31495,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 +31505,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 +31530,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 +31569,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 +31850,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 +31902,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "poe-code",
-      version: "3.0.153",
+      version: "3.0.155",
       description: "CLI tool to configure Poe API for developer workflows.",
       type: "module",
       main: "./dist/index.js",
@@ -31836,7 +31917,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",
@@ -31996,181 +32077,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, path43) {
+  let current = root;
+  for (const segment of path43) {
+    const next = current.commands.find(
+      (command) => Reflect.get(command, "_hidden") !== true && command.name() === segment
+    );
+    if (!next) {
+      throw new Error(`Root help command is missing: ${path43.join(" ")}`);
     }
-  ];
+    current = next;
+  }
+  return current;
+}
+function formatRootHelpCommandName(path43, command) {
+  const leaf = [command.name(), ...command.aliases()].join(", ");
+  return path43.length > 1 ? [...path43.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 +32196,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 +32288,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);
     }
@@ -32317,7 +32316,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 +32355,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";
@@ -32388,6 +32387,38 @@ var init_program = __esm({
     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: ["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"]);
   }
 });