fix(cli-help): clarify usage/examples for apps, schedules, secrets

crates/tower-cmd/src/apps.rs

@@ -9,15 +9,19 @@ pub fn apps_cmd() -> Command {
     Command::new("apps")
         .about("Manage the apps in your current Tower account")
         .arg_required_else_help(true)
-        .subcommand(Command::new("list").about("List all of your apps`"))
+        .subcommand(Command::new("list").about("List all of your apps"))
         .subcommand(
             Command::new("show")
                 .allow_external_subcommands(true)
+                .override_usage("tower apps show [OPTIONS] <APP_NAME>")
+                .after_help("Example: tower apps show hello-world")
                 .about("Show the details about an app in Tower"),
         )
         .subcommand(
             Command::new("logs")
                 .allow_external_subcommands(true)
+                .override_usage("tower apps logs [OPTIONS] <APP_NAME>#<RUN_NUMBER>")
+                .after_help("Example: tower apps logs hello-world#11")
                 .about("Get the logs from a previous Tower app run"),
         )
         .subcommand(
@@ -42,6 +46,8 @@ pub fn apps_cmd() -> Command {
         .subcommand(
             Command::new("delete")
                 .allow_external_subcommands(true)
+                .override_usage("tower apps delete [OPTIONS] <APP_NAME>")
+                .after_help("Example: tower apps delete hello-world")
                 .about("Delete an app in Tower"),
         )
 }

crates/tower-cmd/src/schedules.rs

@@ -72,6 +72,8 @@ pub fn schedules_cmd() -> Command {
         .subcommand(
             Command::new("delete")
                 .allow_external_subcommands(true)
+                .override_usage("tower schedules delete [OPTIONS] <SCHEDULE_ID>")
+                .after_help("Example: tower schedules delete 123")
                 .about("Delete a schedule"),
         )
         .subcommand(
@@ -92,6 +94,8 @@ pub fn schedules_cmd() -> Command {
                         .action(clap::ArgAction::Append),
                 )
                 .allow_external_subcommands(true)
+                .override_usage("tower schedules update [OPTIONS] <SCHEDULE_ID>")
+                .after_help("Example: tower schedules update 123 --cron \"*/15 * * * *\"")
                 .about("Update an existing schedule"),
         )
 }

crates/tower-cmd/src/secrets.rs

@@ -19,6 +19,7 @@ pub fn secrets_cmd() -> Command {
                     Arg::new("show")
                         .short('s')
                         .long("show")
+                        .help("Show secrets in plain text")
                         .action(clap::ArgAction::SetTrue),
                 )
                 .arg(
@@ -27,12 +28,14 @@ pub fn secrets_cmd() -> Command {
                         .long("environment")
                         .default_value("default")
                         .value_parser(value_parser!(String))
+                        .help("List secrets in this environment")
                         .action(clap::ArgAction::Set),
                 )
                 .arg(
                     Arg::new("all")
                         .short('a')
                         .long("all")
+                        .help("List secrets across all environments")
                         .action(clap::ArgAction::SetTrue),
                 )
                 .about("List all of your secrets"),
@@ -45,6 +48,7 @@ pub fn secrets_cmd() -> Command {
                         .long("name")
                         .value_parser(value_parser!(String))
                         .required(true)
+                        .help("Secret name to create")
                         .action(clap::ArgAction::Set),
                 )
                 .arg(
@@ -53,6 +57,7 @@ pub fn secrets_cmd() -> Command {
                         .long("environment")
                         .default_value("default")
                         .value_parser(value_parser!(String))
+                        .help("Environment to store the secret in")
                         .action(clap::ArgAction::Set),
                 )
                 .arg(
@@ -61,13 +66,16 @@ pub fn secrets_cmd() -> Command {
                         .long("value")
                         .value_parser(value_parser!(String))
                         .required(true)
+                        .help("Secret value to store")
                         .action(clap::ArgAction::Set),
                 )
                 .about("Create a new secret in your Tower account"),
         )
         .subcommand(
             Command::new("delete")
                 .allow_external_subcommands(true)
+                .override_usage("tower secrets delete [OPTIONS] <SECRET_NAME>")
+                .after_help("Example: tower secrets delete MY_API_KEY")
                 .about("Delete a secret in Tower"),
         )
 }