feat: add interactive TUI prompts for missing arguments

- Add interactive Bubble Tea prompts when commands are run without required arguments
- New prompt package with TextInput, Select, and SearchSelect components
- Commands now support interactive mode: workout/routine/folder get/update/delete,
  exercise get/search, stats progress, config set, and completion
- Add workout events command for listing workout events
- Add routine delete and folder update/delete commands
- Improve argument validation with cmdutil.RequireArgs helper
- Fix exercise get to always show Custom: Yes/No field

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: obay

cmd/completion/completion.go

@@ -1,17 +1,23 @@
 package completion
 
 import (
+	"fmt"
 	"os"
 
 	"github.com/spf13/cobra"
+
+	"github.com/obay/hevycli/internal/cmdutil"
+	"github.com/obay/hevycli/internal/tui/prompt"
 )
 
 // Cmd is the completion command
 var Cmd = &cobra.Command{
-	Use:   "completion [bash|zsh|fish|powershell]",
+	Use:   "completion <shell>",
 	Short: "Generate shell completion scripts",
 	Long: `Generate shell completion scripts for hevycli.
 
+Supported shells: bash, zsh, fish, powershell
+
 To load completions:
 
 Bash:
@@ -48,18 +54,57 @@ PowerShell:
 `,
 	DisableFlagsInUseLine: true,
 	ValidArgs:             []string{"bash", "zsh", "fish", "powershell"},
-	Args:                  cobra.MatchAll(cobra.ExactArgs(1), cobra.OnlyValidArgs),
-	RunE: func(cmd *cobra.Command, args []string) error {
-		switch args[0] {
-		case "bash":
-			return cmd.Root().GenBashCompletion(os.Stdout)
-		case "zsh":
-			return cmd.Root().GenZshCompletion(os.Stdout)
-		case "fish":
-			return cmd.Root().GenFishCompletion(os.Stdout, true)
-		case "powershell":
-			return cmd.Root().GenPowerShellCompletionWithDesc(os.Stdout)
+	Args: func(cmd *cobra.Command, args []string) error {
+		if len(args) == 0 {
+			// Allow interactive mode to handle it
+			if cmdutil.IsInteractive() {
+				return nil
+			}
+			return fmt.Errorf("please specify a shell: bash, zsh, fish, or powershell\n\nExample: hevycli completion bash")
+		}
+		if len(args) > 1 {
+			return fmt.Errorf("only one shell can be specified at a time")
 		}
-		return nil
+		for _, valid := range []string{"bash", "zsh", "fish", "powershell"} {
+			if args[0] == valid {
+				return nil
+			}
+		}
+		return fmt.Errorf("unknown shell %q\n\nSupported shells: bash, zsh, fish, powershell", args[0])
 	},
+	RunE: runCompletion,
+}
+
+func runCompletion(cmd *cobra.Command, args []string) error {
+	var shell string
+
+	if len(args) == 0 {
+		// Interactive mode - prompt for shell selection
+		options := []prompt.SelectOption{
+			{ID: "bash", Title: "Bash", Description: "GNU Bourne-Again SHell"},
+			{ID: "zsh", Title: "Zsh", Description: "Z shell (macOS default)"},
+			{ID: "fish", Title: "Fish", Description: "Friendly Interactive SHell"},
+			{ID: "powershell", Title: "PowerShell", Description: "Microsoft PowerShell"},
+		}
+
+		selected, err := prompt.Select("Select your shell", options, "Choose the shell for completion scripts")
+		if err != nil {
+			return err
+		}
+		shell = selected.ID
+	} else {
+		shell = args[0]
+	}
+
+	switch shell {
+	case "bash":
+		return cmd.Root().GenBashCompletion(os.Stdout)
+	case "zsh":
+		return cmd.Root().GenZshCompletion(os.Stdout)
+	case "fish":
+		return cmd.Root().GenFishCompletion(os.Stdout, true)
+	case "powershell":
+		return cmd.Root().GenPowerShellCompletionWithDesc(os.Stdout)
+	}
+	return nil
 }

cmd/config/set.go

@@ -7,7 +7,9 @@ import (
 	"github.com/spf13/cobra"
 
 	"github.com/obay/hevycli/internal/api"
+	"github.com/obay/hevycli/internal/cmdutil"
 	"github.com/obay/hevycli/internal/config"
+	"github.com/obay/hevycli/internal/tui/prompt"
 )
 
 var validateKey bool
@@ -30,7 +32,7 @@ Examples:
   hevycli config set units imperial
   hevycli config set default-output json
   hevycli config set color false`,
-	Args: cobra.ExactArgs(2),
+	Args: cmdutil.RequireArgs(2, "<key> <value>"),
 	RunE: runSet,
 }
 
@@ -40,8 +42,81 @@ func init() {
 }
 
 func runSet(cmd *cobra.Command, args []string) error {
-	key := strings.ToLower(args[0])
-	value := args[1]
+	var key, value string
+
+	if len(args) >= 2 {
+		key = strings.ToLower(args[0])
+		value = args[1]
+	} else {
+		// Interactive mode - let user select key and enter value
+		keyOptions := []prompt.SelectOption{
+			{ID: "api-key", Title: "API Key", Description: "Your Hevy API key"},
+			{ID: "default-output", Title: "Default Output", Description: "Output format (json, table, plain)"},
+			{ID: "units", Title: "Units", Description: "Measurement units (metric, imperial)"},
+			{ID: "color", Title: "Color", Description: "Enable/disable colored output"},
+			{ID: "date-format", Title: "Date Format", Description: "Date format (Go format string)"},
+			{ID: "time-format", Title: "Time Format", Description: "Time format (Go format string)"},
+		}
+
+		selected, err := prompt.Select("Select configuration key", keyOptions, "Choose a setting to configure...")
+		if err != nil {
+			return err
+		}
+		key = selected.ID
+
+		// Get value based on key type
+		switch key {
+		case "default-output":
+			outputOptions := []prompt.SelectOption{
+				{ID: "table", Title: "Table", Description: "Formatted table output (default)"},
+				{ID: "json", Title: "JSON", Description: "Raw JSON output"},
+				{ID: "plain", Title: "Plain", Description: "Plain text output"},
+			}
+			selectedOutput, err := prompt.Select("Select output format", outputOptions, "Choose a format...")
+			if err != nil {
+				return err
+			}
+			value = selectedOutput.ID
+
+		case "units":
+			unitsOptions := []prompt.SelectOption{
+				{ID: "metric", Title: "Metric", Description: "Kilograms and kilometers"},
+				{ID: "imperial", Title: "Imperial", Description: "Pounds and miles"},
+			}
+			selectedUnits, err := prompt.Select("Select measurement units", unitsOptions, "Choose units...")
+			if err != nil {
+				return err
+			}
+			value = selectedUnits.ID
+
+		case "color":
+			colorOptions := []prompt.SelectOption{
+				{ID: "true", Title: "Enabled", Description: "Show colored output"},
+				{ID: "false", Title: "Disabled", Description: "Plain monochrome output"},
+			}
+			selectedColor, err := prompt.Select("Enable colored output?", colorOptions, "Choose...")
+			if err != nil {
+				return err
+			}
+			value = selectedColor.ID
+
+		default:
+			// Text input for other keys
+			placeholder := "Enter value..."
+			if key == "api-key" {
+				placeholder = "Enter your Hevy API key..."
+			} else if key == "date-format" {
+				placeholder = "e.g., 2006-01-02"
+			} else if key == "time-format" {
+				placeholder = "e.g., 15:04"
+			}
+
+			value, err = prompt.TextInput("Enter "+key, placeholder, "enter to confirm")
+			if err != nil {
+				return err
+			}
+		}
+	}
 
 	// Load existing config or create default
 	cfg, err := config.Load("")

cmd/exercise/get.go

@@ -8,8 +8,10 @@ import (
 	"github.com/spf13/cobra"
 
 	"github.com/obay/hevycli/internal/api"
+	"github.com/obay/hevycli/internal/cmdutil"
 	"github.com/obay/hevycli/internal/config"
 	"github.com/obay/hevycli/internal/output"
+	"github.com/obay/hevycli/internal/tui/prompt"
 )
 
 var getCmd = &cobra.Command{
@@ -20,13 +22,11 @@ var getCmd = &cobra.Command{
 Examples:
   hevycli exercise get ABC123       # Get exercise by ID
   hevycli exercise get ABC123 -o json  # Output as JSON`,
-	Args: cobra.ExactArgs(1),
+	Args: cmdutil.RequireArgs(1, "<exercise-id>"),
 	RunE: runGet,
 }
 
 func runGet(cmd *cobra.Command, args []string) error {
-	exerciseID := args[0]
-
 	cfg, err := config.Load("")
 	if err != nil {
 		return fmt.Errorf("failed to load config: %w", err)
@@ -39,6 +39,46 @@ func runGet(cmd *cobra.Command, args []string) error {
 
 	client := api.NewClient(apiKey)
 
+	var exerciseID string
+	if len(args) > 0 {
+		exerciseID = args[0]
+	} else {
+		// Interactive mode - let user search and select an exercise
+		selected, err := prompt.SearchSelect(prompt.SearchSelectConfig{
+			Title:       "Select an Exercise",
+			Placeholder: "Search exercises...",
+			Help:        "Type to filter by exercise name",
+			LoadFunc: func() ([]prompt.SelectOption, error) {
+				var allExercises []api.ExerciseTemplate
+				page := 1
+				for {
+					resp, err := client.GetExerciseTemplates(page, 10)
+					if err != nil {
+						return nil, err
+					}
+					allExercises = append(allExercises, resp.ExerciseTemplates...)
+					if page >= resp.PageCount || len(allExercises) > 500 {
+						break
+					}
+					page++
+				}
+				options := make([]prompt.SelectOption, len(allExercises))
+				for i, ex := range allExercises {
+					options[i] = prompt.SelectOption{
+						ID:          ex.ID,
+						Title:       ex.Title,
+						Description: ex.PrimaryMuscleGroup + " • " + ex.Equipment,
+					}
+				}
+				return options, nil
+			},
+		})
+		if err != nil {
+			return err
+		}
+		exerciseID = selected.ID
+	}
+
 	// Get exercise template by fetching from the list
 	// The API may not have a direct /exercise_templates/{id} endpoint that returns full data
 	// So we search through the list
@@ -112,5 +152,7 @@ func printExerciseDetails(ex *api.ExerciseTemplate, cfg *config.Config) {
 
 	if ex.IsCustom {
 		fmt.Println("Custom: Yes")
+	} else {
+		fmt.Println("Custom: No")
 	}
 }

cmd/exercise/search.go

@@ -8,8 +8,10 @@ import (
 	"github.com/spf13/cobra"
 
 	"github.com/obay/hevycli/internal/api"
+	"github.com/obay/hevycli/internal/cmdutil"
 	"github.com/obay/hevycli/internal/config"
 	"github.com/obay/hevycli/internal/output"
+	"github.com/obay/hevycli/internal/tui/prompt"
 )
 
 var (
@@ -28,7 +30,7 @@ Examples:
   hevycli exercise search "press" --muscle chest     # Filter by muscle
   hevycli exercise search "" --equipment barbell     # Filter by equipment only
   hevycli exercise search "curl" -o json             # Output as JSON`,
-	Args: cobra.ExactArgs(1),
+	Args: cmdutil.RequireArgs(1, "<query>"),
 	RunE: runSearch,
 }
 
@@ -39,7 +41,22 @@ func init() {
 }
 
 func runSearch(cmd *cobra.Command, args []string) error {
-	query := strings.ToLower(args[0])
+	var query string
+	if len(args) > 0 {
+		query = strings.ToLower(args[0])
+	} else {
+		// Interactive mode - prompt for search query
+		var err error
+		query, err = prompt.TextInput(
+			"Search Exercises",
+			"Enter search term...",
+			"enter to search",
+		)
+		if err != nil {
+			return err
+		}
+		query = strings.ToLower(query)
+	}
 
 	cfg, err := config.Load("")
 	if err != nil {

cmd/folder/create.go

@@ -7,8 +7,10 @@ import (
 	"github.com/spf13/cobra"
 
 	"github.com/obay/hevycli/internal/api"
+	"github.com/obay/hevycli/internal/cmdutil"
 	"github.com/obay/hevycli/internal/config"
 	"github.com/obay/hevycli/internal/output"
+	"github.com/obay/hevycli/internal/tui/prompt"
 )
 
 var createCmd = &cobra.Command{
@@ -19,7 +21,7 @@ var createCmd = &cobra.Command{
 Examples:
   hevycli folder create "Push Pull"        # Create a folder
   hevycli folder create "My Routines" -o json   # Output as JSON`,
-	Args: cobra.ExactArgs(1),
+	Args: cmdutil.RequireArgs(1, "<title>"),
 	RunE: runFolderCreate,
 }
 
@@ -28,7 +30,24 @@ func init() {
 }
 
 func runFolderCreate(cmd *cobra.Command, args []string) error {
-	title := args[0]
+	var title string
+	if len(args) > 0 {
+		title = args[0]
+	} else {
+		// Interactive mode - prompt for folder title
+		var err error
+		title, err = prompt.TextInput(
+			"Create Folder",
+			"Enter folder name...",
+			"enter to confirm",
+		)
+		if err != nil {
+			return err
+		}
+		if title == "" {
+			return fmt.Errorf("folder title cannot be empty")
+		}
+	}
 
 	cfg, err := config.Load("")
 	if err != nil {