feat: add version flag and subcommand

Author: xbglowx

.github/workflows/build-test.yaml

@@ -22,7 +22,9 @@ jobs:
         go-version-file: 'go.mod'
 
     - name: Build
-      run: go build -v ./...
+      run: |
+        VERSION=$(git describe --tags --always --dirty 2>/dev/null || echo "dev-$(git rev-parse --short HEAD)")
+        go build -v -ldflags "-X github.com/xbglowx/github-org-repos-sync/cmd.Version=$VERSION" ./...
 
     - name: Test
       run: go test -v ./...

.github/workflows/create-release.yaml

@@ -40,7 +40,7 @@ jobs:
         go-version-file: 'go.mod'
 
     - name: Build
-      run: GOOS=${{ matrix.goos }} GOARCH=${{ matrix.goarch }} go build -v -o github-org-repos-sync-${{ matrix.goos }}-${{ matrix.goarch }}
+      run: GOOS=${{ matrix.goos }} GOARCH=${{ matrix.goarch }} go build -v -ldflags "-X github.com/xbglowx/github-org-repos-sync/cmd.Version=${{ needs.release-please.outputs.tag_name }}" -o github-org-repos-sync-${{ matrix.goos }}-${{ matrix.goarch }}
 
     - name: Upload artifact
       uses: actions/upload-artifact@v4

README.md

@@ -34,6 +34,17 @@ Download the latest release for your platform from the [releases page](https://g
    go build .
    ```
 
+   **Optional**: Build with version from git:
+   ```bash
+   VERSION=$(git describe --tags --always --dirty 2>/dev/null || echo "dev-$(git rev-parse --short HEAD)")
+   go build -ldflags "-X github.com/xbglowx/github-org-repos-sync/cmd.Version=$VERSION" .
+   ```
+
+   **Optional**: Build with custom version:
+   ```bash
+   go build -ldflags "-X github.com/xbglowx/github-org-repos-sync/cmd.Version=1.0.0" .
+   ```
+
 ## Prerequisites
 
 ### Authentication
@@ -95,6 +106,16 @@ Download the latest release for your platform from the [releases page](https://g
 ./github-org-repos-sync --help
 ```
 
+#### Check version
+```bash
+# Using version subcommand
+./github-org-repos-sync version
+
+# Using version flag
+./github-org-repos-sync --version
+./github-org-repos-sync -v
+```
+
 ## How It Works
 
 1. **Repository Discovery**: Fetches a list of all repositories in the specified organization that you have access to

cmd/root.go

@@ -24,6 +24,10 @@ import (
 	"github.com/spf13/cobra"
 )
 
+// Version can be set at build time using ldflags:
+// go build -ldflags "-X github.com/xbglowx/github-org-repos-sync/cmd.Version=1.0.0"
+var Version = "dev"
+
 var destPath string
 var excludeRepoString string
 var includeRepoString string
@@ -62,25 +66,50 @@ var rootCmd = &cobra.Command{
 	Long:  "Sync github org repos.",
 
 	PreRunE: func(cmd *cobra.Command, args []string) error {
+		// Check if version flag is set
+		if versionFlag, _ := cmd.Flags().GetBool("version"); versionFlag {
+			fmt.Printf("github-org-repos-sync version %s\n", Version)
+			os.Exit(0)
+		}
 		return checkRequirements()
 	},
 	Run: func(cmd *cobra.Command, args []string) {
 		main(args)
 	},
-	Args:    cobra.ExactArgs(1),
+	Args: func(cmd *cobra.Command, args []string) error {
+		// If version flag is set, don't require args
+		if versionFlag, _ := cmd.Flags().GetBool("version"); versionFlag {
+			return nil
+		}
+		return cobra.ExactArgs(1)(cmd, args)
+	},
 	Example: "github-org-repos-sync floorpunch",
 }
 
+// versionCmd represents the version command
+var versionCmd = &cobra.Command{
+	Use:   "version",
+	Short: "Print the version number",
+	Long:  "Print the version number of github-org-repos-sync",
+	Run: func(cmd *cobra.Command, args []string) {
+		fmt.Printf("github-org-repos-sync version %s\n", Version)
+	},
+}
+
 // Execute adds all child commands to the root command and sets flags appropriately.
 // This is called by main.main(). It only needs to happen once to the rootCmd.
 func Execute() {
 	cobra.CheckErr(rootCmd.Execute())
 }
 
 func init() {
+	rootCmd.AddCommand(versionCmd)
 	rootCmd.Flags().BoolVar(&skipArchived, "skip-archived", false, "Skip archived repos?")
 	rootCmd.Flags().StringVar(&excludeRepoString, "exclude-repos", "", "Exclude repos that contain string")
 	rootCmd.Flags().StringVarP(&destPath, "destination-path", "d", ".", "Destionation path for repos")
 	rootCmd.Flags().StringVar(&includeRepoString, "include-repos", "", "Include only repos that contain string")
 	rootCmd.Flags().IntVarP(&parallelism, "parallelism", "p", 1, "Number of parallel git operations")
+
+	// Add version flag that prints version and exits
+	rootCmd.Flags().BoolP("version", "v", false, "Print version information")
 }