feat(agents): confirm default project or choice before agent init (#704)

Author: rektdeckard

cmd/lk/agent.go

@@ -92,9 +92,11 @@ var (
 			Usage:   "Manage LiveKit Cloud Agents",
 			Commands: []*cli.Command{
 				{
-					Name:   "init",
-					Usage:  "Initialize a new LiveKit Cloud agent project",
-					Before: createAgentClient,
+					Name:  "init",
+					Usage: "Initialize a new LiveKit Cloud agent project",
+					Before: func(ctx context.Context, cmd *cli.Command) (context.Context, error) {
+						return createAgentClientWithOpts(ctx, cmd, confirmProject)
+					},
 					Action: initAgent,
 					MutuallyExclusiveFlags: []cli.MutuallyExclusiveFlags{{
 						Flags: [][]cli.Flag{{
@@ -326,9 +328,13 @@ var (
 )
 
 func createAgentClient(ctx context.Context, cmd *cli.Command) (context.Context, error) {
+	return createAgentClientWithOpts(ctx, cmd)
+}
+
+func createAgentClientWithOpts(ctx context.Context, cmd *cli.Command, opts ...loadOption) (context.Context, error) {
 	var err error
 
-	if _, err := requireProject(ctx, cmd); err != nil {
+	if _, err := requireProjectWithOpts(ctx, cmd, opts...); err != nil {
 		return ctx, err
 	}
 
@@ -459,8 +465,9 @@ func createAgent(ctx context.Context, cmd *cli.Command) error {
 	if !cmd.IsSet("project") {
 		useProject := true
 		if err := huh.NewForm(huh.NewGroup(huh.NewConfirm().
-			Title(fmt.Sprintf("Use [%s] (%s) to create agent deployment?", project.Name, project.URL)).
+			Title(fmt.Sprintf("Use project [%s] (%s) to create agent deployment?", project.Name, project.URL)).
 			Value(&useProject).
+			Negative("Select another").
 			Inline(false).
 			WithTheme(util.Theme))).
 			Run(); err != nil {

cmd/lk/app.go

@@ -131,7 +131,7 @@ func requireProjectWithOpts(ctx context.Context, cmd *cli.Command, opts ...loadO
 		// something is wrong with CLI config file
 		return ctx, err
 	}
-	if project, err = loadProjectDetails(cmd); err != nil {
+	if project, err = loadProjectDetails(cmd, opts...); err != nil {
 		// something is wrong with project config file
 		if errors.Is(err, config.ErrInvalidConfig) {
 			return ctx, err
@@ -159,7 +159,7 @@ func selectProject(ctx context.Context, cmd *cli.Command) (context.Context, erro
 				Value(&project).
 				WithTheme(util.Theme))).
 			Run(); err != nil {
-			return nil, err
+			return nil, fmt.Errorf("no project selected: %w", err)
 		}
 		fmt.Println("Using project [" + util.Accented(project.Name) + "]")
 	} else {
@@ -170,12 +170,12 @@ func selectProject(ctx context.Context, cmd *cli.Command) (context.Context, erro
 			Value(&shouldAuth).
 			WithTheme(util.Theme))).
 			Run(); err != nil {
-			return nil, err
+			return nil, fmt.Errorf("no project selected: %w", err)
 		}
 		if shouldAuth {
 			initAuth(ctx, cmd)
 			if err = tryAuthIfNeeded(ctx, cmd); err != nil {
-				return nil, err
+				return nil, fmt.Errorf("authentication failed: %w", err)
 			}
 			return requireProject(ctx, cmd)
 		} else {

cmd/lk/utils.go

@@ -15,12 +15,14 @@
 package main
 
 import (
+	"context"
 	"errors"
 	"fmt"
 	"maps"
 	"os"
 	"strings"
 
+	"github.com/charmbracelet/huh"
 	"github.com/joho/godotenv"
 	"github.com/twitchtv/twirp"
 	"github.com/urfave/cli/v3"
@@ -217,21 +219,27 @@ func parseKeyValuePairs(c *cli.Command, flag string) (map[string]string, error)
 }
 
 type loadParams struct {
-	requireURL bool
+	requireURL     bool
+	confirmProject bool
 }
 
 type loadOption func(*loadParams)
 
-var ignoreURL = func(p *loadParams) {
-	p.requireURL = false
-}
+var (
+	ignoreURL = func(p *loadParams) {
+		p.requireURL = false
+	}
+	confirmProject = func(p *loadParams) {
+		p.confirmProject = true
+	}
+)
 
 // attempt to load connection config, it'll prioritize
 // 1. command line flags (or env var)
 // 2. config file (by default, livekit.toml)
 // 3. default project config
 func loadProjectDetails(c *cli.Command, opts ...loadOption) (*config.ProjectConfig, error) {
-	p := loadParams{requireURL: true}
+	p := loadParams{requireURL: true, confirmProject: false}
 	for _, opt := range opts {
 		opt(&p)
 	}
@@ -327,9 +335,31 @@ func loadProjectDetails(c *cli.Command, opts ...loadOption) (*config.ProjectConf
 	// load default project
 	dp, err := config.LoadDefaultProject()
 	if err == nil {
-		if !c.Bool("silent") {
-			fmt.Println("Using default project [" + util.Theme.Focused.Title.Render(dp.Name) + "]")
-			logDetails(c, dp)
+		if p.confirmProject {
+			if dp != nil && len(cliConfig.Projects) > 1 && !c.Bool("silent") {
+				useDefault := true
+				if err := huh.NewForm(huh.NewGroup(huh.NewConfirm().
+					Title(fmt.Sprintf("Use project [%s] (%s) to create agent?", dp.Name, dp.URL)).
+					Value(&useDefault).
+					Negative("Select another").
+					Inline(false).
+					WithTheme(util.Theme))).
+					Run(); err != nil {
+					return nil, fmt.Errorf("failed to confirm project: %w", err)
+				}
+				if !useDefault {
+					if _, err = selectProject(context.Background(), c); err != nil {
+						return nil, err
+					}
+					fmt.Printf("Using project [%s]\n", util.Accented(project.Name))
+					return project, nil
+				}
+			}
+		} else {
+			if !c.Bool("silent") {
+				fmt.Println("Using default project [" + util.Theme.Focused.Title.Render(dp.Name) + "]")
+				logDetails(c, dp)
+			}
 		}
 		return dp, nil
 	}

go.sum

@@ -274,8 +274,6 @@ github.com/livekit/mageutil v0.0.0-20250511045019-0f1ff63f7731 h1:9x+U2HGLrSw5AT
 github.com/livekit/mageutil v0.0.0-20250511045019-0f1ff63f7731/go.mod h1:Rs3MhFwutWhGwmY1VQsygw28z5bWcnEYmS1OG9OxjOQ=
 github.com/livekit/mediatransportutil v0.0.0-20250825135402-7bc31f107ade h1:lpxPcglwzUWNB4J0S2qZuyMehzmR7vW9whzSwV4IGoI=
 github.com/livekit/mediatransportutil v0.0.0-20250825135402-7bc31f107ade/go.mod h1:mSNtYzSf6iY9xM3UX42VEI+STHvMgHmrYzEHPcdhB8A=
-github.com/livekit/protocol v1.42.1-0.20250929175250-2ddfb3ee7f7e h1:yytr+uwFXtJ8UxBV2q3j55jVKg7zslECuGeE4F56NoU=
-github.com/livekit/protocol v1.42.1-0.20250929175250-2ddfb3ee7f7e/go.mod h1:vhMS30QoEyH2p34vi6X1eWkC4EMV72ZGZwQb74ajY7A=
 github.com/livekit/protocol v1.42.1-0.20251008181454-49a136864c2d h1:ofC+CPiYDZ4LD+RgIJg4rUFLvKnWJqg66bn00FALKLI=
 github.com/livekit/protocol v1.42.1-0.20251008181454-49a136864c2d/go.mod h1:vhMS30QoEyH2p34vi6X1eWkC4EMV72ZGZwQb74ajY7A=
 github.com/livekit/psrpc v0.7.0 h1:rtfqfjYN06WJYloE/S0nmkJ/Y04x4pxLQLe8kQ4FVHU=