@robinmordasiewicz/xcsh 6.19.0 → 6.20.0

package/dist/index.js

@@ -7936,7 +7936,7 @@ var require_react_reconciler_development = __commonJS({
         var HostPortal = 4;
         var HostComponent = 5;
         var HostText = 6;
-        var Fragment = 7;
+        var Fragment2 = 7;
         var Mode = 8;
         var ContextConsumer = 9;
         var ContextProvider = 10;
@@ -8076,7 +8076,7 @@ var require_react_reconciler_development = __commonJS({
               return "DehydratedFragment";
             case ForwardRef:
               return getWrappedName$1(type, type.render, "ForwardRef");
-            case Fragment:
+            case Fragment2:
               return "Fragment";
             case HostComponent:
               return type;
@@ -11210,7 +11210,7 @@ var require_react_reconciler_development = __commonJS({
             }
           }
           function updateFragment2(returnFiber, current2, fragment, lanes, key) {
-            if (current2 === null || current2.tag !== Fragment) {
+            if (current2 === null || current2.tag !== Fragment2) {
               var created = createFiberFromFragment(fragment, returnFiber.mode, lanes, key);
               created.return = returnFiber;
               return created;
@@ -11613,7 +11613,7 @@ var require_react_reconciler_development = __commonJS({
               if (child.key === key) {
                 var elementType = element.type;
                 if (elementType === REACT_FRAGMENT_TYPE) {
-                  if (child.tag === Fragment) {
+                  if (child.tag === Fragment2) {
                     deleteRemainingChildren(returnFiber, child.sibling);
                     var existing = useFiber(child, element.props.children);
                     existing.return = returnFiber;
@@ -17104,7 +17104,7 @@ var require_react_reconciler_development = __commonJS({
               var _resolvedProps2 = workInProgress2.elementType === type ? _unresolvedProps2 : resolveDefaultProps(type, _unresolvedProps2);
               return updateForwardRef(current2, workInProgress2, type, _resolvedProps2, renderLanes2);
             }
-            case Fragment:
+            case Fragment2:
               return updateFragment(current2, workInProgress2, renderLanes2);
             case Mode:
               return updateMode(current2, workInProgress2, renderLanes2);
@@ -17541,7 +17541,7 @@ var require_react_reconciler_development = __commonJS({
             case SimpleMemoComponent:
             case FunctionComponent:
             case ForwardRef:
-            case Fragment:
+            case Fragment2:
             case Mode:
             case Profiler:
             case ContextConsumer:
@@ -22309,7 +22309,7 @@ var require_react_reconciler_development = __commonJS({
           return fiber;
         }
         function createFiberFromFragment(elements, mode, lanes, key) {
-          var fiber = createFiber(Fragment, elements, key, mode);
+          var fiber = createFiber(Fragment2, elements, key, mode);
           fiber.lanes = lanes;
           return fiber;
         }
@@ -38537,6 +38537,46 @@ function throttle(func, throttleMs = 0, options = {}) {
   });
 }
 
+// node_modules/ansi-escapes/index.js
+var ansi_escapes_exports = {};
+__export(ansi_escapes_exports, {
+  ConEmu: () => ConEmu,
+  beep: () => beep,
+  clearScreen: () => clearScreen,
+  clearTerminal: () => clearTerminal,
+  clearViewport: () => clearViewport,
+  cursorBackward: () => cursorBackward,
+  cursorDown: () => cursorDown,
+  cursorForward: () => cursorForward,
+  cursorGetPosition: () => cursorGetPosition,
+  cursorHide: () => cursorHide,
+  cursorLeft: () => cursorLeft,
+  cursorMove: () => cursorMove,
+  cursorNextLine: () => cursorNextLine,
+  cursorPrevLine: () => cursorPrevLine,
+  cursorRestorePosition: () => cursorRestorePosition,
+  cursorSavePosition: () => cursorSavePosition,
+  cursorShow: () => cursorShow,
+  cursorTo: () => cursorTo,
+  cursorUp: () => cursorUp,
+  default: () => base_exports,
+  enterAlternativeScreen: () => enterAlternativeScreen,
+  eraseDown: () => eraseDown,
+  eraseEndLine: () => eraseEndLine,
+  eraseLine: () => eraseLine,
+  eraseLines: () => eraseLines,
+  eraseScreen: () => eraseScreen,
+  eraseStartLine: () => eraseStartLine,
+  eraseUp: () => eraseUp,
+  exitAlternativeScreen: () => exitAlternativeScreen,
+  iTerm: () => iTerm,
+  image: () => image,
+  link: () => link,
+  scrollDown: () => scrollDown,
+  scrollUp: () => scrollUp,
+  setCwd: () => setCwd
+});
+
 // node_modules/ansi-escapes/base.js
 var base_exports = {};
 __export(base_exports, {
@@ -38733,6 +38773,51 @@ var ConEmu = {
 };
 var setCwd = (cwd2 = cwdFunction()) => iTerm.setCwd(cwd2) + ConEmu.setCwd(cwd2);
 
+// src/stubs/ansi-escapes.ts
+var ESC2 = "\x1B[";
+var eraseScreen2 = `${ESC2}2J`;
+var cursorHome = `${ESC2}H`;
+var patchedClearTerminal = `${eraseScreen2}${cursorHome}`;
+var {
+  beep: beep2,
+  clearScreen: clearScreen2,
+  clearViewport: clearViewport2,
+  cursorBackward: cursorBackward2,
+  cursorDown: cursorDown2,
+  cursorForward: cursorForward2,
+  cursorGetPosition: cursorGetPosition2,
+  cursorHide: cursorHide2,
+  cursorLeft: cursorLeft2,
+  cursorMove: cursorMove2,
+  cursorNextLine: cursorNextLine2,
+  cursorPrevLine: cursorPrevLine2,
+  cursorRestorePosition: cursorRestorePosition2,
+  cursorSavePosition: cursorSavePosition2,
+  cursorShow: cursorShow2,
+  cursorTo: cursorTo2,
+  cursorUp: cursorUp2,
+  enterAlternativeScreen: enterAlternativeScreen2,
+  eraseDown: eraseDown2,
+  eraseEndLine: eraseEndLine2,
+  eraseLine: eraseLine2,
+  eraseLines: eraseLines2,
+  eraseScreen: eraseScreenOriginal,
+  eraseStartLine: eraseStartLine2,
+  eraseUp: eraseUp2,
+  exitAlternativeScreen: exitAlternativeScreen2,
+  image: image2,
+  link: link2,
+  scrollDown: scrollDown2,
+  scrollUp: scrollUp2,
+  setCwd: setCwd2,
+  iTerm: iTerm2,
+  ConEmu: ConEmu2
+} = ansi_escapes_exports;
+var ansi_escapes_default = {
+  ...base_exports,
+  clearTerminal: patchedClearTerminal
+};
+
 // node_modules/is-in-ci/index.js
 import { env } from "process";
 var isInCi = env.CI !== "0" && env.CI !== "false" && ("CI" in env || "CONTINUOUS_INTEGRATION" in env || Object.keys(env).some((key) => key.startsWith("CI_")));
@@ -42856,11 +42941,11 @@ var create = (stream, { showCursor = false } = {}) => {
       return;
     }
     previousOutput = output;
-    stream.write(base_exports.eraseLines(previousLineCount) + output);
+    stream.write(ansi_escapes_default.eraseLines(previousLineCount) + output);
     previousLineCount = output.split("\n").length;
   };
   render2.clear = () => {
-    stream.write(base_exports.eraseLines(previousLineCount));
+    stream.write(ansi_escapes_default.eraseLines(previousLineCount));
     previousOutput = "";
     previousLineCount = 0;
   };
@@ -43535,7 +43620,7 @@ var Ink = class {
       this.fullStaticOutput += staticOutput;
     }
     if (outputHeight >= this.options.stdout.rows) {
-      this.options.stdout.write(base_exports.clearTerminal + this.fullStaticOutput + output);
+      this.options.stdout.write(ansi_escapes_default.clearTerminal + this.fullStaticOutput + output);
       this.lastOutput = output;
       return;
     }
@@ -43688,6 +43773,25 @@ var getInstance = (stdout, createInstance) => {
 
 // node_modules/ink/build/components/Static.js
 var import_react11 = __toESM(require_react(), 1);
+function Static(props) {
+  const { items, children: render2, style: customStyle } = props;
+  const [index, setIndex] = (0, import_react11.useState)(0);
+  const itemsToRender = (0, import_react11.useMemo)(() => {
+    return items.slice(index);
+  }, [items, index]);
+  (0, import_react11.useLayoutEffect)(() => {
+    setIndex(items.length);
+  }, [items.length]);
+  const children = itemsToRender.map((item, itemIndex) => {
+    return render2(item, index + itemIndex);
+  });
+  const style = (0, import_react11.useMemo)(() => ({
+    position: "absolute",
+    flexDirection: "column",
+    ...customStyle
+  }), [customStyle]);
+  return import_react11.default.createElement("ink-box", { internal_static: true, style }, children);
+}
 
 // node_modules/ink/build/components/Transform.js
 var import_react12 = __toESM(require_react(), 1);
@@ -44678,6 +44782,13 @@ function initializeAliasRegistry() {
 function resolveDomain(nameOrAlias) {
   return aliasRegistry.get(nameOrAlias);
 }
+function getDomainInfo(nameOrAlias) {
+  const canonical = resolveDomain(nameOrAlias);
+  if (!canonical) {
+    return void 0;
+  }
+  return domainRegistry.get(canonical);
+}
 function allDomains() {
   return Array.from(domainRegistry.keys()).sort();
 }
@@ -44983,8 +45094,8 @@ var HistoryManager = class _HistoryManager {
 var CLI_NAME = "xcsh";
 var CLI_FULL_NAME = "F5 Distributed Cloud Shell";
 function getVersion() {
-  if ("6.19.0") {
-    return "6.19.0";
+  if ("6.20.0") {
+    return "6.20.0";
   }
   if (process.env.XCSH_VERSION) {
     return process.env.XCSH_VERSION;
@@ -44992,6 +45103,7 @@ function getVersion() {
   return "dev";
 }
 var CLI_VERSION = getVersion();
+var CONFIG_FILE_NAME = ".xcshconfig";
 var ENV_PREFIX = "F5XC";
 var F5_LOGO = `                   ________
               (\u2592\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2592)
@@ -45034,6 +45146,15 @@ var REPO_OWNER = "robinmordasiewicz";
 var REPO_NAME = CLI_NAME;
 var REPO_URL = `https://github.com/${REPO_OWNER}/${REPO_NAME}`;
 var DOCS_URL = `https://${REPO_OWNER}.github.io/${REPO_NAME}/`;
+function colorRed(text) {
+  return `${colors.red}${text}${colors.reset}`;
+}
+function colorBoldWhite(text) {
+  return `${colors.boldWhite}${text}${colors.reset}`;
+}
+function colorDim(text) {
+  return `${colors.dim}${text}${colors.reset}`;
+}
 
 // src/profile/manager.ts
 var import_yaml = __toESM(require_dist(), 1);
@@ -46482,22 +46603,8 @@ var REPLSession = class {
 };
 
 // src/repl/prompt.ts
-function buildPlainPrompt(session) {
-  const parts = [];
-  const profileName = session.getActiveProfileName();
-  if (profileName) {
-    parts.push(`${profileName}@xc`);
-  } else {
-    parts.push("xc");
-  }
-  const ctx = session.getContextPath();
-  if (ctx.domain !== "") {
-    parts.push(ctx.domain);
-    if (ctx.action !== "") {
-      parts.push(ctx.action);
-    }
-  }
-  return `<${parts.join(".")}> `;
+function buildPlainPrompt(_session) {
+  return "> ";
 }
 
 // src/repl/App.tsx
@@ -46778,151 +46885,10 @@ function toDisplayTier(tier) {
 
 // src/repl/components/Banner.tsx
 var import_jsx_runtime3 = __toESM(require_jsx_runtime(), 1);
-var BOX = {
-  topLeft: "\u256D",
-  topRight: "\u256E",
-  bottomLeft: "\u2570",
-  bottomRight: "\u256F",
-  horizontal: "\u2500",
-  vertical: "\u2502",
-  leftT: "\u251C",
-  rightT: "\u2524"
-};
 var TOTAL_WIDTH = 80;
 var INNER_WIDTH = TOTAL_WIDTH - 2;
 var logoLines = F5_LOGO.split("\n");
 var LOGO_WIDTH = Math.max(...logoLines.map((l) => stringWidth(l)));
-var HELP_LINES = [
-  "Type 'help' for commands",
-  "Run 'namespace <ns>' to set",
-  "Press Ctrl+C twice to exit"
-];
-var HELP_START_ROW = 8;
-function padToWidth(str, targetWidth) {
-  const currentWidth = stringWidth(str);
-  if (currentWidth >= targetWidth) return str;
-  return str + " ".repeat(targetWidth - currentWidth);
-}
-function colorizeLogoLine(line) {
-  const elements = [];
-  let currentColor = null;
-  let buffer = "";
-  let keyIndex = 0;
-  const flush = () => {
-    if (buffer) {
-      if (currentColor) {
-        elements.push(
-          /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: currentColor, children: buffer }, keyIndex++)
-        );
-      } else {
-        elements.push(/* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { children: buffer }, keyIndex++));
-      }
-      buffer = "";
-    }
-  };
-  for (const char of line) {
-    let newColor;
-    switch (char) {
-      case "\u2593":
-      // Dark shade - red
-      case "\u2592":
-      // Medium shade - red
-      case "(":
-      case ")":
-      case "|":
-      case "_":
-        newColor = "#E4002B";
-        break;
-      case "\u2588":
-        newColor = "#ffffff";
-        break;
-      default:
-        newColor = null;
-    }
-    if (newColor !== currentColor) {
-      flush();
-      currentColor = newColor;
-    }
-    buffer += char === "\u2593" ? "\u2588" : char;
-  }
-  flush();
-  return elements;
-}
-function buildContentRow(logoLine, helpText, innerWidth) {
-  const paddedLogo = padToWidth(logoLine, LOGO_WIDTH);
-  const helpColumnWidth = innerWidth - LOGO_WIDTH - 1;
-  const paddedHelp = padToWidth(helpText, helpColumnWidth);
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { children: [
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: "#E4002B", children: BOX.vertical }),
-    colorizeLogoLine(paddedLogo),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { children: " " }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { bold: true, color: "#ffffff", children: paddedHelp }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: "#E4002B", children: BOX.vertical })
-  ] });
-}
-function Banner({
-  version,
-  connectionInfo
-}) {
-  const title = ` ${CLI_FULL_NAME} v${version} `;
-  const titleWidth = stringWidth(title);
-  const leftDashes = 3;
-  const rightDashes = TOTAL_WIDTH - 1 - leftDashes - titleWidth - 1;
-  const connectionLines = [];
-  if (!connectionInfo.isConnected) {
-    connectionLines.push("Not connected - run: export F5XC_API_URL=...");
-  } else {
-    if (connectionInfo.tenant) {
-      connectionLines.push(`Tenant: ${connectionInfo.tenant}`);
-    }
-    if (connectionInfo.username) {
-      connectionLines.push(`User: ${connectionInfo.username}`);
-    }
-    if (connectionInfo.tier) {
-      const displayTier = toDisplayTier(connectionInfo.tier);
-      if (displayTier) {
-        connectionLines.push(`Tier: ${displayTier}`);
-      }
-    }
-  }
-  connectionLines.push(`Namespace: ${connectionInfo.namespace}`);
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Box_default, { flexDirection: "column", marginY: 1, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { children: [
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#E4002B", children: [
-        BOX.topLeft,
-        BOX.horizontal.repeat(leftDashes)
-      ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { bold: true, color: "#ffffff", children: title }),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#E4002B", children: [
-        BOX.horizontal.repeat(Math.max(0, rightDashes)),
-        BOX.topRight
-      ] })
-    ] }),
-    logoLines.map((logoLine, index) => {
-      const helpIndex = index - HELP_START_ROW;
-      const helpText = helpIndex >= 0 && helpIndex < HELP_LINES.length ? HELP_LINES[helpIndex] : "";
-      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Box_default, { children: buildContentRow(logoLine, helpText ?? "", INNER_WIDTH) }, index);
-    }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#E4002B", children: [
-      BOX.leftT,
-      BOX.horizontal.repeat(INNER_WIDTH),
-      BOX.rightT
-    ] }),
-    connectionLines.map((line, index) => {
-      const paddedLine = padToWidth(`  ${line}`, INNER_WIDTH);
-      return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { children: [
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: "#E4002B", children: BOX.vertical }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { bold: true, color: "#ffffff", children: paddedLine }),
-        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: "#E4002B", children: BOX.vertical })
-      ] }, index);
-    }),
-    /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "#E4002B", children: [
-      BOX.bottomLeft,
-      BOX.horizontal.repeat(INNER_WIDTH),
-      BOX.bottomRight
-    ] })
-  ] });
-}
 
 // src/repl/components/Suggestions.tsx
 var import_react24 = __toESM(require_react(), 1);
@@ -47199,6 +47165,9 @@ var DomainRegistry = class {
     }
     const firstArg = args[0]?.toLowerCase() ?? "";
     const restArgs = args.slice(1);
+    if (firstArg === "--help" || firstArg === "-h" || firstArg === "help") {
+      return this.showDomainHelp(domain);
+    }
     const subgroup = domain.subcommands.get(firstArg);
     if (subgroup) {
       if (restArgs.length === 0) {
@@ -47856,7 +47825,7 @@ function formatWhoamiBox(info, options) {
   const lines = [];
   const red = colors.red;
   const reset = colors.reset;
-  const BOX2 = {
+  const BOX = {
     topLeft: "\u256D",
     topRight: "\u256E",
     bottomLeft: "\u2570",
@@ -47922,12 +47891,12 @@ function formatWhoamiBox(info, options) {
   const leftDashes = 1;
   const rightDashes = Math.max(0, remainingWidth - leftDashes);
   lines.push(
-    `${red}${BOX2.topLeft}${BOX2.horizontal.repeat(leftDashes)}${reset}${title}${red}${BOX2.horizontal.repeat(rightDashes)}${BOX2.topRight}${reset}`
+    `${red}${BOX.topLeft}${BOX.horizontal.repeat(leftDashes)}${reset}${title}${red}${BOX.horizontal.repeat(rightDashes)}${BOX.topRight}${reset}`
   );
   for (const text of formattedContent) {
     const padding = innerWidth - text.length;
     lines.push(
-      `${red}${BOX2.vertical}${reset} ${text}${" ".repeat(Math.max(0, padding - 1))}${red}${BOX2.vertical}${reset}`
+      `${red}${BOX.vertical}${reset} ${text}${" ".repeat(Math.max(0, padding - 1))}${red}${BOX.vertical}${reset}`
     );
   }
   if (quotaLines.length > 0) {
@@ -47936,12 +47905,12 @@ function formatWhoamiBox(info, options) {
     const quotaLeft = 1;
     const quotaRight = Math.max(0, quotaRemaining - quotaLeft);
     lines.push(
-      `${red}${BOX2.leftT}${BOX2.horizontal.repeat(quotaLeft)}${reset}${quotaTitle}${red}${BOX2.horizontal.repeat(quotaRight)}${BOX2.rightT}${reset}`
+      `${red}${BOX.leftT}${BOX.horizontal.repeat(quotaLeft)}${reset}${quotaTitle}${red}${BOX.horizontal.repeat(quotaRight)}${BOX.rightT}${reset}`
     );
     for (const text of quotaLines) {
       const padding = innerWidth - text.length;
       lines.push(
-        `${red}${BOX2.vertical}${reset} ${text}${" ".repeat(Math.max(0, padding - 1))}${red}${BOX2.vertical}${reset}`
+        `${red}${BOX.vertical}${reset} ${text}${" ".repeat(Math.max(0, padding - 1))}${red}${BOX.vertical}${reset}`
       );
     }
   }
@@ -47951,17 +47920,17 @@ function formatWhoamiBox(info, options) {
     const addonLeft = 1;
     const addonRight = Math.max(0, addonRemaining - addonLeft);
     lines.push(
-      `${red}${BOX2.leftT}${BOX2.horizontal.repeat(addonLeft)}${reset}${addonTitle}${red}${BOX2.horizontal.repeat(addonRight)}${BOX2.rightT}${reset}`
+      `${red}${BOX.leftT}${BOX.horizontal.repeat(addonLeft)}${reset}${addonTitle}${red}${BOX.horizontal.repeat(addonRight)}${BOX.rightT}${reset}`
     );
     for (const text of addonLines) {
       const padding = innerWidth - text.length;
       lines.push(
-        `${red}${BOX2.vertical}${reset} ${text}${" ".repeat(Math.max(0, padding - 1))}${red}${BOX2.vertical}${reset}`
+        `${red}${BOX.vertical}${reset} ${text}${" ".repeat(Math.max(0, padding - 1))}${red}${BOX.vertical}${reset}`
       );
     }
   }
   lines.push(
-    `${red}${BOX2.bottomLeft}${BOX2.horizontal.repeat(innerWidth)}${BOX2.bottomRight}${reset}`
+    `${red}${BOX.bottomLeft}${BOX.horizontal.repeat(innerWidth)}${BOX.bottomRight}${reset}`
   );
   return lines;
 }
@@ -50807,9 +50776,380 @@ function formatAPIError(statusCode, body, operation) {
   return lines.join("\n");
 }
 
+// src/config/envvars.ts
+var EnvVarRegistry = [
+  {
+    name: `${ENV_PREFIX}_API_URL`,
+    description: "API endpoint URL",
+    relatedFlag: "",
+    required: true
+  },
+  {
+    name: `${ENV_PREFIX}_API_TOKEN`,
+    description: "API authentication token",
+    relatedFlag: "",
+    required: true
+  },
+  {
+    name: `${ENV_PREFIX}_NAMESPACE`,
+    description: "Default namespace",
+    relatedFlag: "-ns"
+  },
+  {
+    name: `${ENV_PREFIX}_OUTPUT_FORMAT`,
+    description: "Output format (json, yaml, table)",
+    relatedFlag: "-o"
+  },
+  {
+    name: `${ENV_PREFIX}_SUBSCRIPTION_TIER`,
+    description: "Subscription tier for feature validation",
+    relatedFlag: ""
+  },
+  {
+    name: "NO_COLOR",
+    description: "Disable color output",
+    relatedFlag: "--no-color"
+  }
+];
+function formatEnvVarsSection() {
+  const maxLen = Math.max(...EnvVarRegistry.map((e) => e.name.length));
+  const lines = ["ENVIRONMENT VARIABLES"];
+  for (const env3 of EnvVarRegistry) {
+    const padding = " ".repeat(maxLen - env3.name.length + 3);
+    const flagNote = env3.relatedFlag ? ` [${env3.relatedFlag}]` : "";
+    lines.push(`  ${env3.name}${padding}${env3.description}${flagNote}`);
+  }
+  return lines;
+}
+function formatConfigSection() {
+  return [
+    "CONFIGURATION",
+    `  Config file:  ~/${CONFIG_FILE_NAME}`,
+    "  Priority:     CLI flags > environment variables > config file > defaults",
+    "",
+    "DOCUMENTATION",
+    `  ${DOCS_URL}`
+  ];
+}
+
+// src/repl/help.ts
+function formatRootHelp() {
+  return [
+    "",
+    colorBoldWhite(`${CLI_NAME} - ${CLI_FULL_NAME} v${CLI_VERSION}`),
+    "",
+    "DESCRIPTION",
+    `  Interactive CLI for F5 Distributed Cloud services.`,
+    "",
+    "USAGE",
+    `  ${CLI_NAME}                              Enter interactive REPL mode`,
+    `  ${CLI_NAME} <domain> <action>            Execute command non-interactively`,
+    `  ${CLI_NAME} help [topic]                 Show help for a topic`,
+    "",
+    "EXAMPLES",
+    `  ${CLI_NAME} tenant_and_identity list namespace   List all namespaces`,
+    `  ${CLI_NAME} virtual get http_loadbalancer        Get a specific load balancer`,
+    `  ${CLI_NAME} dns list                             List DNS zones`,
+    `  ${CLI_NAME} waf list -ns prod                    List WAF policies in prod`,
+    `  ${CLI_NAME} --interactive                        Force interactive REPL mode`,
+    "",
+    ...formatDomainsSection(),
+    "",
+    ...formatGlobalFlags(),
+    "",
+    ...formatEnvVarsSection(),
+    "",
+    ...formatConfigSection(),
+    "",
+    "NAVIGATION (Interactive Mode)",
+    "  <domain>              Navigate into a domain (e.g., 'dns', 'lb')",
+    "  /domain               Navigate directly to domain from anywhere",
+    "  ..                    Go up one level",
+    "  /                     Return to root",
+    "  context               Show current navigation context",
+    "",
+    "BUILTINS",
+    "  help                  Show this help",
+    "  domains               List all available domains",
+    "  clear                 Clear the screen",
+    "  history               Show command history",
+    "  quit, exit            Exit the shell",
+    ""
+  ];
+}
+function formatGlobalFlags() {
+  return [
+    "GLOBAL FLAGS",
+    "  -v, --version         Show version number",
+    "  -h, --help            Show this help",
+    "  -i, --interactive     Force interactive mode",
+    "  --no-color            Disable color output",
+    "  -o, --output <fmt>    Output format (json, yaml, table)",
+    "  -ns, --namespace <ns> Target namespace"
+  ];
+}
+function formatEnvironmentVariables() {
+  return formatEnvVarsSection();
+}
+function formatDomainHelp(domain) {
+  const output = ["", colorBoldWhite(`${domain.displayName}`), ""];
+  output.push(`  ${domain.description}`);
+  output.push("");
+  if (domain.category || domain.complexity) {
+    const meta = [];
+    if (domain.category) meta.push(`Category: ${domain.category}`);
+    if (domain.complexity) meta.push(`Complexity: ${domain.complexity}`);
+    output.push(colorDim(`  ${meta.join("  |  ")}`));
+    output.push("");
+  }
+  output.push("USAGE");
+  output.push(`  ${CLI_NAME} ${domain.name} <action> [options]`);
+  output.push("");
+  output.push("ACTIONS");
+  const actionDescriptions = {
+    list: "List resources",
+    get: "Get a specific resource by name",
+    create: "Create a new resource",
+    delete: "Delete a resource",
+    replace: "Replace a resource configuration",
+    apply: "Apply configuration from file",
+    status: "Get resource status",
+    patch: "Patch a resource",
+    "add-labels": "Add labels to a resource",
+    "remove-labels": "Remove labels from a resource"
+  };
+  for (const action of validActions) {
+    const desc = actionDescriptions[action] ?? action;
+    output.push(`  ${action.padEnd(16)} ${desc}`);
+  }
+  output.push("");
+  output.push("EXAMPLES");
+  output.push(`  ${CLI_NAME} ${domain.name} list`);
+  output.push(`  ${CLI_NAME} ${domain.name} get my-resource`);
+  output.push(
+    `  ${CLI_NAME} ${domain.name} create my-resource -f config.yaml`
+  );
+  output.push(`  ${CLI_NAME} ${domain.name} delete my-resource`);
+  output.push("");
+  if (domain.useCases && domain.useCases.length > 0) {
+    output.push("USE CASES");
+    for (const useCase of domain.useCases.slice(0, 5)) {
+      output.push(`  - ${useCase}`);
+    }
+    output.push("");
+  }
+  if (domain.relatedDomains && domain.relatedDomains.length > 0) {
+    output.push("RELATED DOMAINS");
+    output.push(`  ${domain.relatedDomains.join(", ")}`);
+    output.push("");
+  }
+  if (domain.aliases && domain.aliases.length > 0) {
+    output.push("ALIASES");
+    output.push(`  ${domain.aliases.join(", ")}`);
+    output.push("");
+  }
+  output.push(colorDim(`For global options, run: ${CLI_NAME} --help`));
+  output.push("");
+  return output;
+}
+function formatActionHelp(domainName, action) {
+  const domain = getDomainInfo(domainName);
+  const displayDomain = domain?.displayName ?? domainName;
+  const actionDescriptions = {
+    list: {
+      desc: "List all resources in the namespace",
+      usage: `${CLI_NAME} ${domainName} list [--limit N] [--label key=value]`
+    },
+    get: {
+      desc: "Get a specific resource by name",
+      usage: `${CLI_NAME} ${domainName} get <name> [-o json|yaml|table]`
+    },
+    create: {
+      desc: "Create a new resource",
+      usage: `${CLI_NAME} ${domainName} create <name> -f <file.yaml>`
+    },
+    delete: {
+      desc: "Delete a resource by name",
+      usage: `${CLI_NAME} ${domainName} delete <name>`
+    },
+    replace: {
+      desc: "Replace an existing resource configuration",
+      usage: `${CLI_NAME} ${domainName} replace <name> -f <file.yaml>`
+    },
+    apply: {
+      desc: "Apply configuration from a file (create or update)",
+      usage: `${CLI_NAME} ${domainName} apply -f <file.yaml>`
+    },
+    status: {
+      desc: "Get the current status of a resource",
+      usage: `${CLI_NAME} ${domainName} status <name>`
+    },
+    patch: {
+      desc: "Patch specific fields of a resource",
+      usage: `${CLI_NAME} ${domainName} patch <name> -f <patch.yaml>`
+    },
+    "add-labels": {
+      desc: "Add labels to a resource",
+      usage: `${CLI_NAME} ${domainName} add-labels <name> key=value`
+    },
+    "remove-labels": {
+      desc: "Remove labels from a resource",
+      usage: `${CLI_NAME} ${domainName} remove-labels <name> key`
+    }
+  };
+  const actionInfo = actionDescriptions[action] ?? {
+    desc: `Execute ${action} operation`,
+    usage: `${CLI_NAME} ${domainName} ${action} [options]`
+  };
+  return [
+    "",
+    colorBoldWhite(`${displayDomain} - ${action}`),
+    "",
+    `  ${actionInfo.desc}`,
+    "",
+    "USAGE",
+    `  ${actionInfo.usage}`,
+    "",
+    "OPTIONS",
+    "  -n, --name <name>     Resource name",
+    "  -ns, --namespace <ns> Target namespace",
+    "  -o, --output <fmt>    Output format (json, yaml, table)",
+    "  -f, --file <path>     Configuration file",
+    "",
+    colorDim(`For domain help, run: ${CLI_NAME} ${domainName} --help`),
+    ""
+  ];
+}
+function formatTopicHelp(topic) {
+  const lowerTopic = topic.toLowerCase();
+  const domainInfo = getDomainInfo(lowerTopic);
+  if (domainInfo) {
+    return formatDomainHelp(domainInfo);
+  }
+  switch (lowerTopic) {
+    case "domains":
+      return formatDomainsHelp();
+    case "actions":
+      return formatActionsHelp();
+    case "navigation":
+    case "nav":
+      return formatNavigationHelp();
+    case "env":
+    case "environment":
+      return ["", ...formatEnvironmentVariables(), ""];
+    case "flags":
+      return ["", ...formatGlobalFlags(), ""];
+    default:
+      return [
+        "",
+        `Unknown help topic: ${topic}`,
+        "",
+        "Available topics:",
+        "  domains      List all available domains",
+        "  actions      List available actions",
+        "  navigation   Navigation commands",
+        "  env          Environment variables",
+        "  flags        Global flags",
+        "  <domain>     Help for a specific domain (e.g., 'help dns')",
+        ""
+      ];
+  }
+}
+function formatDomainsHelp() {
+  const output = ["", colorBoldWhite("Available Domains"), ""];
+  const categories = /* @__PURE__ */ new Map();
+  for (const domain of domainRegistry.values()) {
+    const category = domain.category ?? "Other";
+    if (!categories.has(category)) {
+      categories.set(category, []);
+    }
+    categories.get(category)?.push(domain);
+  }
+  const sortedCategories = Array.from(categories.keys()).sort();
+  for (const category of sortedCategories) {
+    const domains = categories.get(category) ?? [];
+    output.push(colorBoldWhite(`  ${category}`));
+    for (const domain of domains.sort(
+      (a, b) => a.name.localeCompare(b.name)
+    )) {
+      const aliases = domain.aliases.length > 0 ? ` (${domain.aliases.join(", ")})` : "";
+      output.push(
+        `    ${domain.name.padEnd(24)} ${domain.displayName}${aliases}`
+      );
+    }
+    output.push("");
+  }
+  return output;
+}
+function formatActionsHelp() {
+  return [
+    "",
+    colorBoldWhite("Available Actions"),
+    "",
+    "  list              List all resources in the namespace",
+    "  get               Get a specific resource by name",
+    "  create            Create a new resource from a file",
+    "  delete            Delete a resource by name",
+    "  replace           Replace a resource configuration",
+    "  apply             Apply configuration (create or update)",
+    "  status            Get resource status",
+    "  patch             Patch specific fields of a resource",
+    "  add-labels        Add labels to a resource",
+    "  remove-labels     Remove labels from a resource",
+    "",
+    "USAGE",
+    `  ${CLI_NAME} <domain> <action> [options]`,
+    "",
+    "EXAMPLES",
+    `  ${CLI_NAME} dns list`,
+    `  ${CLI_NAME} lb get my-loadbalancer`,
+    `  ${CLI_NAME} waf create my-policy -f policy.yaml`,
+    ""
+  ];
+}
+function formatNavigationHelp() {
+  return [
+    "",
+    colorBoldWhite("Navigation Commands"),
+    "",
+    "  <domain>          Navigate into a domain context",
+    "  /<domain>         Navigate directly to domain from anywhere",
+    "  ..                Go up one level in context",
+    "  /                 Return to root context",
+    "  back              Go up one level (same as ..)",
+    "  root              Return to root (same as /)",
+    "",
+    "CONTEXT DISPLAY",
+    "  context           Show current navigation context",
+    "  ctx               Alias for context",
+    "",
+    "EXAMPLES",
+    "  xcsh> dns                    # Enter dns domain",
+    "  dns> list                    # Execute list in dns context",
+    "  dns> ..                      # Return to root",
+    "  xcsh> /waf                   # Jump directly to waf",
+    "  waf> /dns                    # Jump from waf to dns",
+    ""
+  ];
+}
+function formatDomainsSection() {
+  const output = ["DOMAINS"];
+  const domains = Array.from(domainRegistry.values()).sort(
+    (a, b) => a.name.localeCompare(b.name)
+  );
+  const maxNameLen = Math.max(...domains.map((d) => d.name.length));
+  for (const domain of domains) {
+    const padding = " ".repeat(maxNameLen - domain.name.length + 2);
+    output.push(`  ${domain.name}${padding}${domain.description}`);
+  }
+  return output;
+}
+
 // src/repl/executor.ts
 var BUILTIN_COMMANDS = /* @__PURE__ */ new Set([
   "help",
+  "--help",
+  "-h",
   "clear",
   "quit",
   "exit",
@@ -50858,9 +51198,11 @@ function parseCommand(input) {
     };
   }
   const firstWord = trimmed.split(/\s+/)[0]?.toLowerCase() ?? "";
-  if (BUILTIN_COMMANDS.has(firstWord)) {
+  const normalizedFirst = firstWord.startsWith("/") ? firstWord.slice(1) : firstWord;
+  if (BUILTIN_COMMANDS.has(firstWord) || BUILTIN_COMMANDS.has(normalizedFirst)) {
+    const effectiveCommand = normalizedFirst === "--help" || normalizedFirst === "-h" ? "help" : normalizedFirst;
     return {
-      raw: trimmed,
+      raw: effectiveCommand,
       isDirectNavigation: false,
       isBuiltin: true,
       args: trimmed.split(/\s+/).slice(1)
@@ -51027,32 +51369,57 @@ function executeBuiltin(cmd, session, ctx) {
     }));
   }
   if (command === "help" || command.startsWith("help ")) {
+    const topic = cmd.args[0]?.trim() ?? "";
+    if (topic) {
+      return {
+        output: formatTopicHelp(topic),
+        shouldExit: false,
+        shouldClear: false,
+        contextChanged: false
+      };
+    }
+    if (ctx.isRoot()) {
+      return {
+        output: formatRootHelp(),
+        shouldExit: false,
+        shouldClear: false,
+        contextChanged: false
+      };
+    }
+    if (ctx.isDomain()) {
+      const domain = ctx.domain ?? "";
+      const domainInfo = getDomainInfo(domain);
+      if (domainInfo) {
+        return {
+          output: formatDomainHelp(domainInfo),
+          shouldExit: false,
+          shouldClear: false,
+          contextChanged: false
+        };
+      }
+      return {
+        output: [
+          `Help for domain: ${domain}`,
+          "",
+          "Use 'help' at root for full help."
+        ],
+        shouldExit: false,
+        shouldClear: false,
+        contextChanged: false
+      };
+    }
+    if (ctx.isAction()) {
+      const domain = ctx.domain ?? "";
+      const action = ctx.action ?? "";
+      return {
+        output: formatActionHelp(domain, action),
+        shouldExit: false,
+        shouldClear: false,
+        contextChanged: false
+      };
+    }
     return {
-      output: [
-        "xcsh - F5 Distributed Cloud Shell",
-        "",
-        "Navigation:",
-        "  /domain         Navigate directly to domain",
-        "  exit, back, ..  Navigate up one level (exits at root)",
-        "  /, root         Navigate to root context",
-        "  context, ctx    Show current context",
-        "",
-        "Built-in commands:",
-        "  help            Show this help",
-        "  clear           Clear the screen",
-        "  quit            Exit the shell",
-        "  history         Show command history",
-        "  domains         List available domains",
-        "  whoami          Show current user and connection (-q/--quota, -a/--addons, -v/--verbose, --json)",
-        "  version         Show version info",
-        "",
-        "Keyboard shortcuts:",
-        "  Tab             Trigger/cycle completions",
-        "  Up/Down         Navigate history or suggestions",
-        "  Ctrl+C twice    Exit (within 500ms)",
-        "  Ctrl+D          Exit immediately",
-        "  Escape          Cancel suggestions"
-      ],
+      output: formatRootHelp(),
       shouldExit: false,
       shouldClear: false,
       contextChanged: false
@@ -51083,6 +51450,27 @@ async function handleDirectNavigation(cmd, ctx, session) {
     );
     return customDomains.execute(canonicalDomain, allArgs, session);
   }
+  if (cmd.targetAction === "--help" || cmd.targetAction === "-h" || cmd.targetAction === "help") {
+    const domainInfo = getDomainInfo(cmd.targetDomain);
+    if (domainInfo) {
+      return {
+        output: formatDomainHelp(domainInfo),
+        shouldExit: false,
+        shouldClear: false,
+        contextChanged: false
+      };
+    }
+    return {
+      output: [
+        `${cmd.targetDomain} - Run '${cmd.targetDomain}' for available commands.`,
+        "",
+        `For global options, run: help`
+      ],
+      shouldExit: false,
+      shouldClear: false,
+      contextChanged: false
+    };
+  }
   const extensionDomain = aliasRegistry.get(cmd.targetDomain) ?? cmd.targetDomain;
   const merged = extensionRegistry.getMergedDomain(extensionDomain);
   if (merged?.hasExtension && cmd.targetAction) {
@@ -51166,6 +51554,28 @@ async function handleDomainNavigation(domain, args, ctx, session) {
     const canonicalDomain = resolveDomainAlias(domain);
     return customDomains.execute(canonicalDomain, args, session);
   }
+  const firstArg = args[0]?.toLowerCase() ?? "";
+  if (firstArg === "--help" || firstArg === "-h" || firstArg === "help") {
+    const domainInfo = getDomainInfo(domain);
+    if (domainInfo) {
+      return {
+        output: formatDomainHelp(domainInfo),
+        shouldExit: false,
+        shouldClear: false,
+        contextChanged: false
+      };
+    }
+    return {
+      output: [
+        `${domain} - Run '${domain}' for available commands.`,
+        "",
+        `For global options, run: help`
+      ],
+      shouldExit: false,
+      shouldClear: false,
+      contextChanged: false
+    };
+  }
   const merged = extensionRegistry.getMergedDomain(domain);
   if (merged?.hasExtension) {
     if (args.length > 0) {
@@ -51508,9 +51918,9 @@ function App2() {
     },
     []
   );
-  const [output, setOutput] = (0, import_react28.useState)([]);
-  const [showBanner, setShowBanner] = (0, import_react28.useState)(true);
-  const [prompt, setPrompt] = (0, import_react28.useState)("<xc> ");
+  const [outputItems, setOutputItems] = (0, import_react28.useState)([]);
+  const outputIdRef = (0, import_react28.useRef)(0);
+  const [prompt, setPrompt] = (0, import_react28.useState)("> ");
   const [width, setWidth] = (0, import_react28.useState)(stdout?.columns ?? 80);
   const [gitInfo, setGitInfo] = (0, import_react28.useState)(void 0);
   const [statusHint, setStatusHint] = (0, import_react28.useState)("Ctrl+C twice to exit");
@@ -51558,12 +51968,17 @@ function App2() {
     };
   }, [stdout]);
   const addOutput = (0, import_react28.useCallback)((line) => {
-    setOutput((prev) => {
-      const newLines = [...prev, ...line.split("\n")];
-      if (newLines.length > 1e3) {
-        return newLines.slice(newLines.length - 1e3);
+    const lines = line.split("\n");
+    const newItems = lines.map((content) => ({
+      id: outputIdRef.current++,
+      content
+    }));
+    setOutputItems((prev) => {
+      const combined = [...prev, ...newItems];
+      if (combined.length > 1e3) {
+        return combined.slice(combined.length - 1e3);
       }
-      return newLines;
+      return combined;
     });
   }, []);
   const applyCompletion = (0, import_react28.useCallback)(
@@ -51605,10 +52020,9 @@ function App2() {
       const trimmed = cmd.trim();
       if (!trimmed) return;
       addOutput(prompt + trimmed);
-      setShowBanner(false);
       const result = await executeCommand(trimmed, session);
       if (result.shouldClear) {
-        setOutput([]);
+        setOutputItems([]);
       } else {
         result.output.forEach((line) => addOutput(line));
       }
@@ -51672,10 +52086,17 @@ function App2() {
     if (key.tab) {
       const currentInput = inputRef.current;
       if (completion.isShowing) {
-        if (key.shift) {
-          completion.navigateUp();
-        } else {
-          completion.navigateDown();
+        const selected = completion.suggestions.at(
+          completion.selectedIndex
+        );
+        if (selected) {
+          applyCompletion({
+            label: selected.text,
+            value: selected.text,
+            description: selected.description,
+            category: selected.category ?? "builtin"
+          });
+          completion.hide();
         }
       } else {
         completion.triggerCompletion(currentInput).then((suggestion) => {
@@ -51742,52 +52163,151 @@ function App2() {
     },
     [applyCompletion, completion]
   );
-  if (!isInitialized) {
-    return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Box_default, { children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { children: "Initializing..." }) });
-  }
-  const maxOutputLines = Math.max(5, 20);
-  const connectionInfo = {
-    tenant: session.getTenant() || void 0,
-    username: session.getUsername() || void 0,
-    tier: session.getTier() || void 0,
-    namespace: session.getNamespace(),
-    isConnected: session.isConnected()
-  };
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(Box_default, { flexDirection: "column", width, children: [
-    showBanner && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Banner, { version: CLI_VERSION, connectionInfo }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Box_default, { flexDirection: "column", children: output.slice(-maxOutputLines).map((line, i) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { children: line }, i)) }),
-    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
-      InputBox,
-      {
-        prompt,
-        value: input,
-        onChange: handleInputChange,
-        onSubmit: handleSubmit,
-        width,
-        isActive: true,
-        inputKey
-      }
-    ),
-    completion.isShowing && completion.suggestions.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
-      Suggestions,
-      {
-        suggestions: toUISuggestions(completion.suggestions),
-        selectedIndex: completion.selectedIndex,
-        onSelect: handleSuggestionSelect,
-        onNavigate: handleSuggestionNavigate,
-        onCancel: completion.hide,
-        maxVisible: 10,
-        isActive: false
-      }
-    ) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(StatusBar, { gitInfo, width, hint: statusHint })
+    /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Static, { items: outputItems, children: (item) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { children: item.content }, item.id) }),
+    isInitialized ? /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_jsx_runtime5.Fragment, { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        InputBox,
+        {
+          prompt,
+          value: input,
+          onChange: handleInputChange,
+          onSubmit: handleSubmit,
+          width,
+          isActive: true,
+          inputKey
+        }
+      ),
+      completion.isShowing && completion.suggestions.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        Suggestions,
+        {
+          suggestions: toUISuggestions(
+            completion.suggestions
+          ),
+          selectedIndex: completion.selectedIndex,
+          onSelect: handleSuggestionSelect,
+          onNavigate: handleSuggestionNavigate,
+          onCancel: completion.hide,
+          maxVisible: 10,
+          isActive: false
+        }
+      ) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+        StatusBar,
+        {
+          gitInfo,
+          width,
+          hint: statusHint
+        }
+      )
+    ] }) : /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { children: "Initializing..." })
   ] });
 }
 
 // src/index.tsx
 var import_jsx_runtime6 = __toESM(require_jsx_runtime(), 1);
+function colorizeLogoLine(line) {
+  let result = "";
+  let currentColor = "none";
+  for (const char of line) {
+    let newColor;
+    switch (char) {
+      case "\u2593":
+      // Dark shade - red (rendered as solid block)
+      case "\u2592":
+      // Medium shade - red
+      case "(":
+      case ")":
+      case "|":
+      case "_":
+        newColor = "red";
+        break;
+      case "\u2588":
+        newColor = "white";
+        break;
+      default:
+        newColor = "none";
+    }
+    if (newColor !== currentColor) {
+      if (currentColor !== "none") {
+        result += colors.reset;
+      }
+      if (newColor === "red") {
+        result += colors.red;
+      } else if (newColor === "white") {
+        result += colors.boldWhite;
+      }
+      currentColor = newColor;
+    }
+    result += char === "\u2593" ? "\u2588" : char;
+  }
+  if (currentColor !== "none") {
+    result += colors.reset;
+  }
+  return result;
+}
+function printBannerToScrollback() {
+  const BOX = {
+    topLeft: "\u256D",
+    topRight: "\u256E",
+    bottomLeft: "\u2570",
+    bottomRight: "\u256F",
+    horizontal: "\u2500",
+    vertical: "\u2502",
+    leftT: "\u251C",
+    rightT: "\u2524"
+  };
+  const logoLines2 = F5_LOGO.split("\n");
+  const logoWidth = Math.max(...logoLines2.map((l) => [...l].length));
+  const TOTAL_WIDTH2 = Math.max(80, logoWidth + 4);
+  const INNER_WIDTH2 = TOTAL_WIDTH2 - 2;
+  const HELP_LINES = [
+    "Type 'help' for commands",
+    "Run 'namespace <ns>' to set",
+    "Press Ctrl+C twice to exit"
+  ];
+  const HELP_START_ROW = 8;
+  const title = ` ${CLI_FULL_NAME} v${CLI_VERSION} `;
+  const leftDashes = 3;
+  const rightDashes = TOTAL_WIDTH2 - 1 - leftDashes - title.length - 1;
+  const output = [];
+  output.push(
+    colorRed(BOX.topLeft + BOX.horizontal.repeat(leftDashes)) + colorBoldWhite(title) + colorRed(
+      BOX.horizontal.repeat(Math.max(0, rightDashes)) + BOX.topRight
+    )
+  );
+  for (let i = 0; i < logoLines2.length; i++) {
+    const logoLine = logoLines2[i] ?? "";
+    const helpIndex = i - HELP_START_ROW;
+    const helpText = helpIndex >= 0 && helpIndex < HELP_LINES.length ? HELP_LINES[helpIndex] ?? "" : "";
+    const paddedLogo = logoLine.padEnd(logoWidth);
+    const coloredLogo = colorizeLogoLine(paddedLogo);
+    const helpColumnWidth = INNER_WIDTH2 - logoWidth - 1;
+    const paddedHelp = helpText.padEnd(helpColumnWidth);
+    output.push(
+      colorRed(BOX.vertical) + coloredLogo + " " + colorBoldWhite(paddedHelp) + colorRed(BOX.vertical)
+    );
+  }
+  output.push(
+    colorRed(
+      BOX.bottomLeft + BOX.horizontal.repeat(INNER_WIDTH2) + BOX.bottomRight
+    )
+  );
+  output.push("");
+  process.stdout.write(output.join("\n") + "\n");
+}
 var program2 = new Command();
-program2.name(CLI_NAME).description("F5 Distributed Cloud Shell - Interactive CLI for F5 XC").version(CLI_VERSION, "-v, --version", "Show version number").option("-i, --interactive", "Force interactive mode").option("--no-color", "Disable color output").argument("[command...]", "Command to execute non-interactively").allowUnknownOption(true).action(
+program2.configureHelp({
+  formatHelp: () => formatRootHelp().join("\n")
+});
+program2.name(CLI_NAME).description("F5 Distributed Cloud Shell - Interactive CLI for F5 XC").version(CLI_VERSION, "-v, --version", "Show version number").option("-i, --interactive", "Force interactive mode").option("--no-color", "Disable color output").option("-h, --help", "Show help").argument("[command...]", "Command to execute non-interactively").allowUnknownOption(true).helpOption(false).action(
   async (commandArgs, options) => {
+    if (options.help && commandArgs.length === 0) {
+      formatRootHelp().forEach((line) => console.log(line));
+      process.exit(0);
+    }
+    if (options.help && commandArgs.length > 0) {
+      commandArgs.push("--help");
+    }
     if (commandArgs.length === 0 || options.interactive) {
       if (!process.stdin.isTTY && !options.interactive) {
         console.error(
@@ -51798,6 +52318,7 @@ program2.name(CLI_NAME).description("F5 Distributed Cloud Shell - Interactive CL
         );
         process.exit(1);
       }
+      printBannerToScrollback();
       process.stdin.resume();
       render_default(/* @__PURE__ */ (0, import_jsx_runtime6.jsx)(App2, {}));
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robinmordasiewicz/xcsh",
-  "version": "6.19.0",
+  "version": "6.20.0",
   "description": "F5 Distributed Cloud Shell - Interactive CLI for F5 XC",
   "type": "module",
   "bin": {
@@ -25,6 +25,7 @@
     "build:binaries": "./scripts/build-binaries.sh",
     "build:release": "npm run build && npm run build:binaries",
     "dev": "tsx src/index.tsx",
+    "build:dev": "npm run build && ${HOME}/.bun/bin/bun build dist/index.js --compile --outfile ./xcsh",
     "start": "node dist/index.js",
     "test": "vitest",
     "test:coverage": "vitest --coverage",