cli: make bundled help self-describing

2026-03-22 23:37:38 +08:00
parent 5859ff219e
commit 4d8c90eb26
49 changed files with 792 additions and 29 deletions
@@ -21,6 +21,13 @@ func newRenewCmd(root *rootOptions) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "renew",
 		Short: "Extend an existing lease",
+		Long: helpLong(
+			"Use renew to extend an active worker lease on one claimed thread.",
+			"renew only applies when the caller already owns the active lease.",
+			"Use renew for long-running work instead of risking lease expiry mid-execution.",
+		),
+		Example: `  inbox --db .agents/coord.db renew --agent worker-a --thread thr_123
+  inbox --db .agents/coord.db renew --agent worker-a --thread thr_123 --lease-seconds 1800`,
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()