fix: improve root command long help text and use more descriptive errors when account id or api key are missing (#66)

Author: Davidonium

internal/cli/root.go

@@ -24,7 +24,13 @@ func NewRootCommand(s *state.State) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:   "qcloud",
 		Short: "Qdrant Cloud CLI",
-		Long:  "The command-line interface for Qdrant Cloud",
+		Long: `The command-line interface for Qdrant Cloud.
+
+Get started:
+  qcloud context set default --api-key <KEY> --account-id <ID>
+  qcloud cluster list
+
+Documentation: https://github.com/qdrant/qcloud-cli`,
 		PersistentPreRunE: func(cmd *cobra.Command, args []string) error {
 			if err := s.Config.Load(configPath); err != nil {
 				return err

internal/state/state.go

@@ -2,6 +2,7 @@ package state
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"log/slog"
 
@@ -10,6 +11,11 @@ import (
 	"github.com/qdrant/qcloud-cli/internal/state/config"
 )
 
+var (
+	errNoAPIKey    = errors.New("no API Key configured — set QDRANT_CLOUD_API_KEY, use --api-key, or run \"qcloud context set\" to save credentials")
+	errNoAccountID = errors.New("no account ID configured — set QDRANT_CLOUD_ACCOUNT_ID, use --account-id, or run \"qcloud context set\" to save credentials")
+)
+
 // Updater checks for and applies CLI updates.
 type Updater interface {
 	DetectLatest(ctx context.Context) (*selfupgrade.ReleaseInfo, bool, error)
@@ -42,7 +48,7 @@ func (s *State) Client(ctx context.Context) (*qcloudapi.Client, error) {
 
 	key := s.Config.APIKey()
 	if key == "" {
-		return nil, fmt.Errorf("no API Key configured — set QDRANT_CLOUD_API_KEY or use --api-key")
+		return nil, errNoAPIKey
 	}
 
 	c, err := qcloudapi.New(ctx, s.Config.Endpoint(), key, s.Version)
@@ -83,7 +89,7 @@ func (s *State) SetUpdater(u Updater) {
 func (s *State) AccountID() (string, error) {
 	id := s.Config.AccountID()
 	if id == "" {
-		return "", fmt.Errorf("no account ID configured — set QDRANT_CLOUD_ACCOUNT_ID or use --account-id")
+		return "", errNoAccountID
 	}
 	return id, nil
 }