golang-spf13-cobra

To structure a Go CLI command tree, define a root command and register subcommands to organize help output with groups for predictable nested command execution. Use spf13/cobra patterns to establish the hierarchy and match real CLI UX expectations.

The PersistentPreRunE hook inheritance in spf13/cobra executes before every nested subcommand. It chains through the lifecycle as PersistentPreRunE → PreRunE → RunE → PostRunE → PersistentPostRunE, allowing consistent auth or config initialization across the command tree.

To validate CLI arguments in Go without manual checks, apply cobra Args validators instead of writing custom validation logic. This ensures robust argument handling by leveraging built-in validation patterns aligned with cobra's APIs.

The best way to define persistent vs local flags in a Go CLI is using spf13/cobra's flag mechanisms. Persistent flags inherit down to nested subcommands, while local flags apply only to the specific command, ensuring correct configuration scoping.

To test cobra command output and shell completion in Go, use SetArgs, SetOut, and SetErr patterns to capture execution results. Implement dynamic argument completion functions and route output via cmd.OutOrStdout and cmd.ErrOrStderr for accurate testing.

You should use RunE instead of Run for cobra command execution to return errors directly through the command tree. RunE ensures predictable error handling and proper hook chaining without requiring manual error exiting or os.Exit calls.