feat(alert): add alert issues and metrics list commands

docs/public/.well-known/skills/index.json

@@ -5,6 +5,7 @@
       "description": "Guide for using the Sentry CLI to interact with Sentry from the command line. Use when the user asks about viewing issues, events, projects, organizations, making API calls, or authenticating with Sentry via CLI.",
       "files": [
         "SKILL.md",
+        "references/alert.md",
         "references/api.md",
         "references/auth.md",
         "references/dashboards.md",

plugins/sentry-cli/skills/sentry-cli/SKILL.md

@@ -254,6 +254,15 @@ Make an authenticated API request
 
 → Full flags and examples: `references/api.md`
 
+### Alert
+
+Manage Sentry alert rules
+
+- `sentry alert issues list <org/project>` — List issue alert rules
+- `sentry alert metrics list <org/>` — List metric alert rules
+
+→ Full flags and examples: `references/alert.md`
+
 ### Cli
 
 CLI-related commands

plugins/sentry-cli/skills/sentry-cli/references/alert.md

@@ -0,0 +1,34 @@
+---
+name: sentry-cli-alert
+version: 0.21.0-dev.0
+description: Sentry CLI alert commands
+requires:
+  bins: ["sentry"]
+  auth: true
+---
+
+# alert Commands
+
+Manage Sentry alert rules
+
+### `sentry alert issues list <org/project>`
+
+List issue alert rules
+
+**Flags:**
+- `-w, --web - Open in browser`
+- `-n, --limit <value> - Maximum number of issue alert rules to list - (default: "30")`
+- `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
+- `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)`
+
+### `sentry alert metrics list <org/>`
+
+List metric alert rules
+
+**Flags:**
+- `-w, --web - Open in browser`
+- `-n, --limit <value> - Maximum number of metric alert rules to list - (default: "30")`
+- `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
+- `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)`
+
+All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.

src/app.ts

@@ -8,6 +8,7 @@ import {
   UnexpectedPositionalError,
 } from "@stricli/core";
 import { apiCommand } from "./commands/api.js";
+import { alertRoute } from "./commands/alert/index.js";
 import { authRoute } from "./commands/auth/index.js";
 import { whoamiCommand } from "./commands/auth/whoami.js";
 import { cliRoute } from "./commands/cli/index.js";
@@ -67,6 +68,7 @@ const PLURAL_TO_SINGULAR: Record<string, string> = {
 export const routes = buildRouteMap({
   routes: {
     help: helpCommand,
+    alert: alertRoute,
     auth: authRoute,
     cli: cliRoute,
     dashboard: dashboardRoute,

src/commands/alert/index.ts

@@ -0,0 +1,19 @@
+import { buildRouteMap } from "@stricli/core";
+import { issuesRoute } from "./issues/index.js";
+import { metricsRoute } from "./metrics/index.js";
+
+export const alertRoute = buildRouteMap({
+  routes: {
+    issues: issuesRoute,
+    metrics: metricsRoute,
+  },
+  docs: {
+    brief: "Manage Sentry alert rules",
+    fullDescription:
+      "View and manage alert rules in your Sentry organization.\n\n" +
+      "Alert types:\n" +
+      "  issues    Issue alert rules — trigger on matching error events (project-scoped)\n" +
+      "  metrics   Metric alert rules — trigger on metric query thresholds (org-scoped)",
+    hideRoute: {},
+  },
+});

src/commands/alert/issues/index.ts

@@ -0,0 +1,16 @@
+import { buildRouteMap } from "@stricli/core";
+import { listCommand } from "./list.js";
+
+export const issuesRoute = buildRouteMap({
+  routes: {
+    list: listCommand,
+  },
+  docs: {
+    brief: "Manage issue alert rules",
+    fullDescription:
+      "View and manage issue alert rules in your Sentry projects.\n\n" +
+      "Commands:\n" +
+      "  list   List issue alert rules",
+    hideRoute: {},
+  },
+});