cli-patterns

Context

Hyoka's CLI is built with Cobra, a popular Go CLI framework. Commands are organized in the cmd/ package with consistent flag naming and help text patterns.

Command Structure

Each command is a Cobra command object:

// cmd/run.go
var runCmd = &cobra.Command{
    Use:   "run",
    Short: "Run evaluation",
    Long:  "Run an evaluation with prompts and configs.",
    
    Args: cobra.NoArgs,  // Positional arguments check
    
    RunE: func(cmd *cobra.Command, args []string) error {
        // Retrieve flags
        promptID, _ := cmd.Flags().GetString("prompt-id")
        config, _ := cmd.Flags().GetString("config")
        
        // Validate
        if promptID == "" && config == "" {
            return fmt.Errorf("either --prompt-id or --config required")
        }
        
        // Execute
        return run(promptID, config)
    },
}

func init() {
    rootCmd.AddCommand(runCmd)
    runCmd.Flags().StringP("prompt-id", "", "", "Single prompt ID")
    runCmd.Flags().StringP("config", "", "", "Config (comma-sep for multiple)")
}

Flag Naming Conventions