feat: enhance commitmsg CLI with improved examples flag handling

- Updated `--examples` flag to accept a custom number of examples (1-20).
- Added support for positional arguments to specify examples count.
- Improved validation and error handling for `--examples` flag input.
- Enhanced README documentation to reflect new `--examples` functionality.
- Refactored code to ensure proper cleanup of HTTP response bodies.

This update provides greater flexibility for users to customize the number
of example commit messages used in context, improving usability and clarity.

Author: hazadus

README.md

@@ -2,7 +2,9 @@
 
 Based on [gh-standup](https://github.com/sgoedecke/gh-standup) by Sean Goedecke.
 
-A GitHub CLI extension that generates AI-powered commit messages using staged git changes from current repository. It uses free [GitHub Models](https://docs.github.com/en/github-models) for inference, so you don't need to do any token setup - your existing GitHub CLI token will do fine!
+A GitHub CLI extension that generates AI-powered [conventional commit](https://www.conventionalcommits.org/en/v1.0.0/#summary) messages using staged git changes from current repository. It uses free [GitHub Models](https://docs.github.com/en/github-models) for inference, so you don't need to do any token setup - your existing GitHub CLI token will do fine!
+
+If you find this utility useful, check my another tool – [gh-repomon](https://github.com/hazadus/gh-repomon).
 
 ## Installation
 
@@ -49,9 +51,12 @@ You can use and combine different options:
 # Use different language
 gh commitmsg --language russian
 
-# Use previous 3 commit messages as an example for LLM
+# Use previous commit messages as examples for LLM (default: 3, max: 20)
 gh commitmsg --examples
 
+# Or specify custom number of examples
+gh commitmsg --examples 5
+
 # Use a different AI model
 gh commitmsg --model xai/grok-3-mini
 ```

cmd/commitmsg/main.go

@@ -4,32 +4,55 @@ package main
 import (
 	"fmt"
 	"os"
+	"strconv"
 
 	"github.com/hazadus/gh-commitmsg/internal/git"
 	"github.com/hazadus/gh-commitmsg/internal/llm"
 	"github.com/spf13/cobra"
 )
 
-const extensionName = "commitmsg"
+const (
+	extensionName = "commitmsg"
+	maxExamples   = 20
+)
 
 var (
 	flagLanguage string
-	flagExamples bool
-	flagModel string
+	flagExamples string
+	flagModel    string
 )
 var rootCmd = &cobra.Command{
 	Use:   extensionName,
 	Short: "Generate AI-powered commit messages",
 	Long:  "A GitHub CLI extension that generates commit messages using GitHub Models and git repo data",
 	RunE:  runCommitMsg,
+	Args:  handleArgs,
 }
 
 func init() {
 	rootCmd.Flags().StringVarP(&flagLanguage, "language", "l", "english", "Language to generate commit message in")
-	rootCmd.Flags().BoolVarP(&flagExamples, "examples", "e", false, "Add examples of commit messages to context")
+	rootCmd.Flags().StringVarP(&flagExamples, "examples", "e", "", "Add N examples of commit messages to context (default 3 if flag is set without value, max 20)")
+	rootCmd.Flags().Lookup("examples").NoOptDefVal = "3"
 	rootCmd.Flags().StringVarP(&flagModel, "model", "m", "openai/gpt-4o", "GitHub Models model to use")
 }
 
+// handleArgs processes positional arguments to support --examples N syntax
+func handleArgs(cmd *cobra.Command, args []string) error {
+	// If --examples was set to its NoOptDefVal and there's a positional arg, use it
+	if flagExamples == "3" && len(args) == 1 {
+		// Check if examples flag was actually set
+		if cmd.Flags().Changed("examples") {
+			flagExamples = args[0]
+			return nil
+		}
+	}
+	// No positional arguments allowed normally
+	if len(args) > 0 {
+		return fmt.Errorf("unexpected argument: %s", args[0])
+	}
+	return nil
+}
+
 func main() {
 	if err := rootCmd.Execute(); err != nil {
 		fmt.Fprintf(os.Stderr, "Error: %v\n", err)
@@ -42,20 +65,32 @@ func runCommitMsg(_ *cobra.Command, _ []string) error {
 	if err != nil {
 		return fmt.Errorf("failed to get staged changes: %w", err)
 	}
-	
+
 	if stagedChanges == "" {
 		fmt.Println("No staged changes in the repository.")
 		return nil
 	}
 
+	// Parse and validate examples count
+	examplesCount := 0
+	if flagExamples != "" {
+		examplesCount, err = strconv.Atoi(flagExamples)
+		if err != nil {
+			return fmt.Errorf("invalid examples count: %s", flagExamples)
+		}
+		if examplesCount < 1 || examplesCount > maxExamples {
+			return fmt.Errorf("examples count must be between 1 and %d", maxExamples)
+		}
+	}
+
 	// Add examples of previous commit messages to context if the flag is set
 	latestCommitMessages := ""
-	if flagExamples {
-		latestCommitMessages, err = git.GetCommitMessages(3)
+	if examplesCount > 0 {
+		latestCommitMessages, err = git.GetCommitMessages(examplesCount)
 		if err != nil {
 			return fmt.Errorf("failed to get latest commit messages: %w", err)
 		}
-		fmt.Println("  Adding examples of previous commit messages to context")
+		fmt.Printf("  Adding %d example(s) of previous commit messages to context\n", examplesCount)
 	}
 
 	llmClient, err := llm.NewClient()

internal/llm/client.go

@@ -179,7 +179,7 @@ func (c *Client) callGitHubModels(request Request) (*Response, error) {
 	if err != nil {
 		return nil, fmt.Errorf("failed to make request: %w", err)
 	}
-	defer resp.Body.Close()
+	defer func() { _ = resp.Body.Close() }()
 
 	body, err := io.ReadAll(resp.Body)
 	if err != nil {
@@ -203,6 +203,6 @@ func createExamplesString(examples string) string {
 	if examples == "" {
 		return ""
 	}
-	
+
 	return fmt.Sprintf("Here are some examples of good commit messages used previously in project:\n%s", examples)
-}
+}