docs(cli): update commands descriptions

Author: rafbgarcia

internal/cli/commands/delete.go

@@ -41,7 +41,7 @@ func WithDeleteServer(server *config.Server) DeleteOption {
 func NewDeleteCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "delete <branch-name>",
-		Short: "Delete a database branch",
+		Short: "Delete a branch",
 		Args:  cobra.ExactArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return runDelete(args[0])

internal/cli/commands/init.go

@@ -28,7 +28,7 @@ func WithSkipBrowser(skip bool) InitOption {
 func NewInitCmd() *cobra.Command {
 	return &cobra.Command{
 		Use:   "init <ip-address>",
-		Short: "Init a new branchd server",
+		Short: "Setup a new branchd server",
 		Args:  cobra.ExactArgs(1),
 		RunE:  runInit,
 	}

internal/cli/commands/list.go

@@ -52,7 +52,7 @@ func NewListCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:     "ls",
 		Aliases: []string{"list"},
-		Short:   "List all branches",
+		Short:   "List branches",
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return runList()
 		},

internal/cli/commands/login.go

@@ -59,7 +59,7 @@ func NewLoginCmd() *cobra.Command {
 
 	cmd := &cobra.Command{
 		Use:   "login",
-		Short: "Authenticate with a Branchd server",
+		Short: "Login to a branchd server",
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return runLogin(email, password)
 		},

internal/cli/commands/select_server.go

@@ -13,16 +13,15 @@ import (
 func NewSelectServerCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "select-server [ip-or-alias]",
-		Short: "Select the default server to use for commands",
-		Long: `Select the default server to use for commands.
+		Short: "Select the server to use for commands",
+		Long: `Select the server to use for commands.
 
-If no IP or alias is provided, an interactive prompt will be shown.
-Otherwise, you can directly specify a server by its IP address or alias.
+If no param is provided, an interactive prompt will be shown.
 
 Examples:
-  branchd select-server              # Interactive selection
-  branchd select-server 192.168.1.1  # Select by IP
-  branchd select-server production   # Select by alias`,
+  $ branchd select-server              # Interactive selection
+  $ branchd select-server 192.168.1.1  # Select by IP
+  $ branchd select-server production   # Select by alias`,
 		Args: cobra.MaximumNArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
 			var ipOrAlias string

internal/cli/commands/update_server.go

@@ -12,11 +12,7 @@ import (
 func NewUpdateServerCmd() *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "update-server",
-		Short: "Update the Branchd server to the latest version",
-		Long: `Triggers a server update on all configured servers.
-
-The server will download the latest release, stop services, install new binaries,
-and restart automatically. This takes approximately 1 minute.`,
+		Short: "Update all branchd servers version",
 		RunE: func(cmd *cobra.Command, args []string) error {
 			return runUpdateServer()
 		},

internal/cli/root.go

@@ -12,12 +12,8 @@ import (
 var version = "dev" // Will be set during build
 
 var rootCmd = &cobra.Command{
-	Use:   "branchd",
-	Short: "Branchd - Database branching for PostgreSQL",
-	Long: `Branchd CLI - Manage your database branches with ease.
-
-Branchd uses ZFS copy-on-write snapshots to create instant database branches
-for development, testing, and PR environments.`,
+	Use:           "branchd",
+	Short:         "PostgreSQL database branching",
 	SilenceUsage:  true,
 	SilenceErrors: true,
 	PersistentPreRun: func(cmd *cobra.Command, args []string) {
@@ -35,7 +31,7 @@ func init() {
 	// Add version command
 	rootCmd.AddCommand(&cobra.Command{
 		Use:   "version",
-		Short: "Print the version number",
+		Short: "Show version",
 		Run: func(cmd *cobra.Command, args []string) {
 			fmt.Printf("branchd version %s\n", version)
 		},