update help contents a little more

cmd/branch.go

@@ -31,7 +31,7 @@ func init() {
 }
 
 var branchCmd = &cobra.Command{
-	Use:               "branch",
+	Use:               "branch [<branchname>]",
 	Short:             "Manage branches across all repos in a directory",
 	Long:              `List, create, delete, move, or show the current branch across all repos in a directory.`,
 	Args:              cobra.MaximumNArgs(2),

cmd/clone.go

@@ -22,9 +22,13 @@ func init() {
 }
 
 var cloneCmd = &cobra.Command{
-	Use:               "clone [user|org] [directory]",
-	Short:             "Clone all active repos from an org or user",
-	Long:              `Clone all active (non-archived) repositories from a GitHub org or user into the target directory. The optional directory argument specifies where to clone the repos (defaults to the current directory).`,
+	Use:   "clone [user|org] [directory]",
+	Short: "Clone all active repos from an org or user",
+	Long: `Clone all active (non-archived) repositories from a GitHub org or user into the target directory.
+The optional directory argument specifies where to clone the repos (defaults to the current directory).
+
+When --topics is provided multiple times, only repos that have ALL specified topics are cloned (AND logic).
+To clone repos matching any one topic, run separate clone invocations per topic.`,
 	Args:              cobra.MaximumNArgs(2),
 	ValidArgsFunction: createCmdValidArgsFunc,
 	PersistentPreRun:  setupClient,

cmd/log.go

@@ -26,7 +26,7 @@ func init() {
 }
 
 var logCmd = &cobra.Command{
-	Use:   "log",
+	Use:   "log [<since>..<until>]",
 	Short: "Show commit logs for all repos in a directory",
 	Long: `Show commit logs all repos in a directory. Since commit hashes would not be the same between
 multiple repos this command really only makes sense when used with two branch names or two tags.`,

cmd/push.go

@@ -29,7 +29,7 @@ func init() {
 }
 
 var pushCmd = &cobra.Command{
-	Use:               "push",
+	Use:               "push [<remote>] [<branch|tag>]",
 	Short:             "Push all repos in a directory",
 	Long:              `Push local commits to the remote across all repos in a directory.`,
 	ValidArgsFunction: pushCmdValidArgsFunc,