Improve command line help

cmd/build.go

@@ -37,7 +37,7 @@ func NewBuildCmd(flags *flags.GlobalFlags) *cobra.Command {
 		GlobalFlags: flags,
 	}
 	buildCmd := &cobra.Command{
-		Use:   "build",
+		Use:   "build [flags] [workspace-path|workspace-name]",
 		Short: "Builds a workspace",
 		RunE: func(_ *cobra.Command, args []string) error {
 			ctx := context.Background()

cmd/delete.go

@@ -26,7 +26,7 @@ func NewDeleteCmd(flags *flags.GlobalFlags) *cobra.Command {
 		GlobalFlags: flags,
 	}
 	deleteCmd := &cobra.Command{
-		Use:   "delete",
+		Use:   "delete [flags] [workspace-path|workspace-name]",
 		Short: "Deletes an existing workspace",
 		RunE: func(_ *cobra.Command, args []string) error {
 			_, err := clientimplementation.DecodeOptionsFromEnv(clientimplementation.DevPodFlagsDelete, &cmd.DeleteOptions)

cmd/export.go

@@ -24,7 +24,7 @@ func NewExportCmd(flags *flags.GlobalFlags) *cobra.Command {
 		GlobalFlags: flags,
 	}
 	exportCmd := &cobra.Command{
-		Use:   "export",
+		Use:   "export [flags] [workspace-path|workspace-name]",
 		Short: "Exports a workspace configuration",
 		RunE: func(_ *cobra.Command, args []string) error {
 			ctx := context.Background()

cmd/ide/use.go

@@ -27,10 +27,13 @@ func NewUseCmd(flags *flags.GlobalFlags) *cobra.Command {
 	}
 	useCmd := &cobra.Command{
 		Use:   "use",
-		Short: "Configure the default IDE to use",
+		Short: "Configure the default IDE to use (list available IDEs with 'devpod ide list')",
+		Long: `Configure the default IDE to use
+
+Available IDEs can be listed with 'devpod ide list'`,
 		RunE: func(_ *cobra.Command, args []string) error {
 			if len(args) != 1 {
-				return fmt.Errorf("please specify the ide to use")
+				return fmt.Errorf("please specify the ide to use, list available IDEs with 'devpod ide list'")
 			}
 
 			return cmd.Run(context.Background(), args[0])

cmd/logs.go

@@ -28,7 +28,7 @@ func NewLogsCmd(flags *flags.GlobalFlags) *cobra.Command {
 		GlobalFlags: flags,
 	}
 	startCmd := &cobra.Command{
-		Use:   "logs",
+		Use:   "logs [flags] [workspace-path|workspace-name]",
 		Short: "Prints the workspace logs on the machine",
 		RunE: func(_ *cobra.Command, args []string) error {
 			return cmd.Run(context.Background(), args)

cmd/ssh.go

@@ -62,7 +62,7 @@ func NewSSHCmd(f *flags.GlobalFlags) *cobra.Command {
 		GlobalFlags: f,
 	}
 	sshCmd := &cobra.Command{
-		Use:   "ssh",
+		Use:   "ssh [flags] [workspace-folder|workspace-name]",
 		Short: "Starts a new ssh session to a workspace",
 		RunE: func(_ *cobra.Command, args []string) error {
 			devPodConfig, err := config.LoadConfig(cmd.Context, cmd.Provider)

cmd/status.go

@@ -31,7 +31,7 @@ func NewStatusCmd(flags *flags.GlobalFlags) *cobra.Command {
 		GlobalFlags: flags,
 	}
 	statusCmd := &cobra.Command{
-		Use:   "status",
+		Use:   "status [flags] [workspace-path|workspace-name]",
 		Short: "Shows the status of a workspace",
 		RunE: func(_ *cobra.Command, args []string) error {
 			_, err := clientimplementation.DecodeOptionsFromEnv(clientimplementation.DevPodFlagsStatus, &cmd.StatusOptions)

cmd/stop.go

@@ -24,7 +24,7 @@ func NewStopCmd(flags *flags.GlobalFlags) *cobra.Command {
 		GlobalFlags: flags,
 	}
 	stopCmd := &cobra.Command{
-		Use:     "stop",
+		Use:     "stop [flags] [workspace-path|workspace-name]",
 		Aliases: []string{"down"},
 		Short:   "Stops an existing workspace",
 		RunE: func(_ *cobra.Command, args []string) error {

cmd/up.go

@@ -71,7 +71,7 @@ func NewUpCmd(f *flags.GlobalFlags) *cobra.Command {
 		GlobalFlags: f,
 	}
 	upCmd := &cobra.Command{
-		Use:   "up",
+		Use:   "up [flags] [workspace-path|workspace-name]",
 		Short: "Starts a new workspace",
 		RunE: func(_ *cobra.Command, args []string) error {
 			devPodConfig, err := config.LoadConfig(cmd.Context, cmd.Provider)