diff --git a/internal/cli/alert.go b/internal/cli/alert.go
index d460193..1f216a5 100644
--- a/internal/cli/alert.go
+++ b/internal/cli/alert.go
@@ -111,7 +111,7 @@ func newAlertListCmd() *cobra.Command {
 	cmd.Flags().BoolVar(&muted, "muted", false, "Show ever-muted only")
 	cmd.Flags().StringVar(&since, "since", "24h", "Start time")
 	cmd.Flags().StringVar(&until, "until", "now", "End time")
-	cmd.Flags().IntVar(&limit, "limit", 20, "Max results")
+	cmd.Flags().IntVar(&limit, "limit", 20, "Max results (max 100)")
 	cmd.Flags().IntVar(&page, "page", 1, "Page number")
 	cmd.Flags().StringVar(&fields, "fields", "", "Comma-separated fields to project in json/toon output (e.g. alert_id,title,alert_severity,created_at); ignored in table mode. Use to avoid dumping the full nested record.")
 
diff --git a/internal/cli/alert_event.go b/internal/cli/alert_event.go
index dbb7024..4e8c0fb 100644
--- a/internal/cli/alert_event.go
+++ b/internal/cli/alert_event.go
@@ -104,7 +104,7 @@ func newAlertEventListCmd() *cobra.Command {
 	cmd.Flags().StringVar(&integrationType, "integration-type", "", "Comma-separated integration types")
 	cmd.Flags().StringVar(&since, "since", "1h", "Start time")
 	cmd.Flags().StringVar(&until, "until", "now", "End time")
-	cmd.Flags().IntVar(&limit, "limit", 20, "Max results")
+	cmd.Flags().IntVar(&limit, "limit", 20, "Max results (max 100)")
 	cmd.Flags().IntVar(&page, "page", 1, "Page number")
 	cmd.Flags().StringVar(&fields, "fields", "", "Comma-separated fields to project in json/toon output (e.g. event_id,alert_id,event_severity,event_status,event_time,title); ignored in table mode. Defaults to these compact event fields. Long strings are truncated as needed to keep structured output below 16 KiB.")
 
diff --git a/internal/cli/insight.go b/internal/cli/insight.go
index f3b4a5f..a2e02bd 100644
--- a/internal/cli/insight.go
+++ b/internal/cli/insight.go
@@ -138,7 +138,7 @@ func newInsightIncidentsCmd() *cobra.Command {
 
 	cmd.Flags().StringVar(&since, "since", "7d", "Start time")
 	cmd.Flags().StringVar(&until, "until", "now", "End time")
-	cmd.Flags().IntVar(&limit, "limit", 20, "Max results")
+	cmd.Flags().IntVar(&limit, "limit", 20, "Max results (max 100)")
 	cmd.Flags().IntVar(&page, "page", 1, "Page number")
 
 	return cmd