From 6c4ac8088267fb3a33113f9df7f4e00f38231737 Mon Sep 17 00:00:00 2001
From: "zeyu.fz" <zeyu.fz@alibaba-inc.com>
Date: Mon, 15 Jun 2026 19:49:09 +0800
Subject: [PATCH] feat(cli): add support for displaying command notes in help
 output

---
 packages/cli/src/registry.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/cli/src/registry.ts b/packages/cli/src/registry.ts
index 70ed9f8..f1e7cef 100644
--- a/packages/cli/src/registry.ts
+++ b/packages/cli/src/registry.ts
@@ -243,6 +243,12 @@ ${b("Getting Help:")}
         out.write(`  ${a(opt.flag.padEnd(maxLen + 2))} ${d(opt.description)}\n`);
       }
     }
+    if (cmd.notes && cmd.notes.length > 0) {
+      out.write(`\n${b("Notes:")}\n`);
+      for (const note of cmd.notes) {
+        out.write(`  ${note}\n`);
+      }
+    }
     if (cmd.examples && cmd.examples.length > 0) {
       out.write(`\n${b("Examples:")}\n`);
       for (const ex of cmd.examples) {