From d956a6b56dabac9690260e50a9e03372510877d4 Mon Sep 17 00:00:00 2001
From: Ogulcan Celik <ogulcancelik@gmail.com>
Date: Mon, 20 Jul 2026 20:22:30 +0300
Subject: fix: show agent targets before options in help

---
 src/cli/spec.rs | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'src/cli')

diff --git a/src/cli/spec.rs b/src/cli/spec.rs
index 7fa08550..f3d0d271 100644
--- a/src/cli/spec.rs
+++ b/src/cli/spec.rs
@@ -320,6 +320,7 @@ fn agent_command() -> Command {
         .subcommand(
             Command::new("read")
                 .about("Read agent terminal output")
+                .override_usage("herdr agent read <TARGET> [OPTIONS]")
                 .arg(required("target", "TARGET"))
                 .arg(read_source_option(true))
                 .arg(option("lines", "N"))
@@ -336,6 +337,7 @@ fn agent_command() -> Command {
         .subcommand(
             Command::new("prompt")
                 .about("Submit a prompt to an agent")
+                .override_usage("herdr agent prompt <TARGET> <TEXT> [OPTIONS]")
                 .arg(required("target", "TARGET"))
                 .arg(required("text", "TEXT"))
                 .arg(
@@ -375,6 +377,7 @@ fn agent_command() -> Command {
         .subcommand(
             Command::new("wait")
                 .about("Wait until an agent reaches one of the requested states")
+                .override_usage("herdr agent wait <TARGET> [OPTIONS]")
                 .arg(required("target", "TARGET"))
                 .arg(
                     option("until", "STATUS")
@@ -390,12 +393,16 @@ fn agent_command() -> Command {
         .subcommand(
             Command::new("attach")
                 .about("Attach directly to an agent terminal")
+                .override_usage("herdr agent attach <TARGET> [OPTIONS]")
                 .arg(required("target", "TARGET"))
                 .arg(flag("takeover")),
         )
         .subcommand(
             Command::new("start")
                 .about("Start a supported interactive agent in an existing pane")
+                .override_usage(
+                    "herdr agent start <NAME> --kind <KIND> --pane <ID> [OPTIONS] [-- [AGENT_ARG]...]",
+                )
                 .arg(required("name", "NAME"))
                 .arg(
                     option("kind", "KIND")
-- 
cgit v1.2.3