docs(commands): add alias info to subcommand help output

Each command group and its list subcommand now mention the plural
shortcut in help text, e.g. `sentry issue` and `sentry issue list`
both show that `sentry issues` is an alias for `sentry issue list`.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: betegon

src/commands/issue/index.ts

@@ -26,7 +26,8 @@ export const issueRoute = buildRouteMap({
       "Examples:\n" +
       "  sentry issue view @latest\n" +
       "  sentry issue explain @most_frequent\n" +
-      "  sentry issue plan my-org/@latest",
+      "  sentry issue plan my-org/@latest\n\n" +
+      "Alias: `sentry issues` → `sentry issue list`",
     hideRoute: {},
   },
 });

src/commands/issue/list.ts

@@ -1265,7 +1265,8 @@ export const listCommand = buildListCommand("issue", {
       "Projects with fewer issues than their share give their surplus to others. " +
       "Use --cursor / -c last to paginate through larger result sets.\n\n" +
       "By default, only issues with activity in the last 90 days are shown. " +
-      "Use --period to adjust (e.g. --period 24h, --period 14d).",
+      "Use --period to adjust (e.g. --period 24h, --period 14d).\n\n" +
+      "Alias: `sentry issues` → `sentry issue list`",
   },
   output: issueListOutput,
   parameters: {

src/commands/log/index.ts

@@ -19,7 +19,8 @@ export const logRoute = buildRouteMap({
       "View and stream logs from your Sentry projects.\n\n" +
       "Commands:\n" +
       "  list     List or stream logs from a project\n" +
-      "  view     View details of a specific log entry",
+      "  view     View details of a specific log entry\n\n" +
+      "Alias: `sentry logs` → `sentry log list`",
     hideRoute: {},
   },
 });

src/commands/log/list.ts

@@ -553,7 +553,8 @@ export const listCommand = buildListCommand("log", {
       "  sentry log list -f 5               # Stream logs (5s poll interval)\n" +
       "  sentry log list --limit 50         # Show last 50 logs\n" +
       "  sentry log list -q 'level:error'   # Filter to errors only\n" +
-      "  sentry log list --trace abc123def456abc123def456abc123de  # Filter by trace",
+      "  sentry log list --trace abc123def456abc123def456abc123de  # Filter by trace\n\n" +
+      "Alias: `sentry logs` → `sentry log list`",
   },
   output: {
     human: createLogRenderer,

src/commands/org/index.ts

@@ -9,7 +9,9 @@ export const orgRoute = buildRouteMap({
   },
   docs: {
     brief: "Work with Sentry organizations",
-    fullDescription: "List and manage Sentry organizations you have access to.",
+    fullDescription:
+      "List and manage Sentry organizations you have access to.\n\n" +
+      "Alias: `sentry orgs` → `sentry org list`",
     hideRoute: {},
   },
 });

src/commands/org/list.ts

@@ -115,7 +115,8 @@ export const listCommand = buildCommand({
       "Examples:\n" +
       "  sentry org list\n" +
       "  sentry org list --limit 10\n" +
-      "  sentry org list --json",
+      "  sentry org list --json\n\n" +
+      "Alias: `sentry orgs` → `sentry org list`",
   },
   output: { human: formatOrgListHuman },
   parameters: {

src/commands/project/index.ts

@@ -11,7 +11,9 @@ export const projectRoute = buildRouteMap({
   },
   docs: {
     brief: "Work with Sentry projects",
-    fullDescription: "List and manage Sentry projects in your organizations.",
+    fullDescription:
+      "List and manage Sentry projects in your organizations.\n\n" +
+      "Alias: `sentry projects` → `sentry project list`",
     hideRoute: {},
   },
 });

src/commands/project/list.ts

@@ -561,7 +561,8 @@ export const listCommand = buildListCommand("project", {
       "Filtering and output:\n" +
       "  sentry project list --platform javascript  # filter by platform\n" +
       "  sentry project list --limit 50              # show more results\n" +
-      "  sentry project list --json                  # output as JSON",
+      "  sentry project list --json                  # output as JSON\n\n" +
+      "Alias: `sentry projects` → `sentry project list`",
   },
   output: {
     human: (result: ListResult<ProjectWithOrg>) => {

src/commands/repo/index.ts

@@ -8,7 +8,8 @@ export const repoRoute = buildRouteMap({
   docs: {
     brief: "Work with Sentry repositories",
     fullDescription:
-      "List and manage repositories connected to your Sentry organizations.",
+      "List and manage repositories connected to your Sentry organizations.\n\n" +
+      "Alias: `sentry repos` → `sentry repo list`",
     hideRoute: {},
   },
 });

src/commands/repo/list.ts

@@ -66,7 +66,8 @@ const docs: OrgListCommandDocs = {
     "  sentry repo list              # auto-detect or list all\n" +
     "  sentry repo list my-org/      # list repositories in my-org (paginated)\n" +
     "  sentry repo list --limit 10\n" +
-    "  sentry repo list --json",
+    "  sentry repo list --json\n\n" +
+    "Alias: `sentry repos` → `sentry repo list`",
 };
 
 export const listCommand = buildOrgListCommand(repoListConfig, docs, "repo");