From fbc91c3ed989e7745d9c83bd6a2e35391f30b830 Mon Sep 17 00:00:00 2001
From: Matt Pearce <mattp@fly.io>
Date: Wed, 3 Dec 2025 06:58:20 +1100
Subject: [PATCH] Clarify CLI options

---
 internal/flag/flag.go     | 6 +++---
 internal/flag/machines.go | 8 ++++----
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/internal/flag/flag.go b/internal/flag/flag.go
index 8d6442d21d..194b7973dc 100644
--- a/internal/flag/flag.go
+++ b/internal/flag/flag.go
@@ -343,7 +343,7 @@ func Yes() Bool {
 	return Bool{
 		Name:        flagnames.Yes,
 		Shorthand:   "y",
-		Description: "Accept all confirmations",
+		Description: "Accept all confirmations (also --auto-confirm)",
 		Aliases:     []string{"auto-confirm"},
 	}
 }
@@ -436,7 +436,7 @@ const httpsFailover = "https-failover"
 func HttpsFailover() Bool {
 	return Bool{
 		Name:        httpsFailover,
-		Description: "Determines whether to failover to plain internet(https) communication with remote builders if wireguard fails",
+		Description: "Determines whether to failover to plain internet(https) communication with remote builders if wireguard fails (also --http-failover)",
 		Aliases:     []string{"http-failover"},
 		Default:     true,
 	}
@@ -636,7 +636,7 @@ func JSONOutput() Bool {
 
 func ProcessGroup(desc string) String {
 	if desc == "" {
-		desc = "The target process group"
+		desc = "The target process group (also --group)"
 	}
 
 	return String{
diff --git a/internal/flag/machines.go b/internal/flag/machines.go
index 629a73e846..63d1c6d509 100644
--- a/internal/flag/machines.go
+++ b/internal/flag/machines.go
@@ -108,17 +108,17 @@ var VMSizeFlags = Set{
 	},
 	Int{
 		Name:        "vm-cpus",
-		Description: "Number of CPUs",
+		Description: "Number of CPUs (also --cpus)",
 		Aliases:     []string{"cpus"},
 	},
 	String{
 		Name:        "vm-cpu-kind",
-		Description: "The kind of CPU to use ('shared' or 'performance')",
+		Description: "The kind of CPU to use ('shared' or 'performance') (also --vm-cpukind)",
 		Aliases:     []string{"vm-cpukind"},
 	},
 	String{
 		Name:        "vm-memory",
-		Description: "Memory (in megabytes) to attribute to the VM",
+		Description: "Memory (in megabytes) to attribute to the VM (also --memory)",
 		Aliases:     []string{"memory"},
 	},
 	Int{
@@ -127,7 +127,7 @@ var VMSizeFlags = Set{
 	},
 	String{
 		Name:        "vm-gpu-kind",
-		Description: fmt.Sprintf("If set, the GPU model to attach (%v)", strings.Join(validGPUKinds, ", ")),
+		Description: fmt.Sprintf("If set, the GPU model to attach (%v) (also --vm-gpukind)", strings.Join(validGPUKinds, ", ")),
 		Aliases:     []string{"vm-gpukind"},
 	},
 	String{