Improve --version output with update check feedback (#252)

* Update version notification copy

Improve the --version update notification:
- Highlight new version in bold for visibility
- Suggest `brew upgrade render` as primary update method
- Link to docs for other installation options

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

* Add "up to date" message for --version

Show confirmation when CLI is already on the latest version,
so users know the version check completed successfully.

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

* Use generic upgrade instructions for version check

Remove Mac-specific `brew upgrade render` command and link to docs
instead, making the message appropriate for all platforms.

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

* Fix broken InstallationInstructionsURL anchor link

The docs page anchor changed from #1-install to #1-install-or-upgrade.

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

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: Borets

cmd/root.go

@@ -14,6 +14,7 @@ import (
 
 	"github.com/render-oss/cli/pkg/cfg"
 	"github.com/render-oss/cli/pkg/client"
+	"github.com/render-oss/cli/pkg/client/version"
 	"github.com/render-oss/cli/pkg/command"
 	"github.com/render-oss/cli/pkg/config"
 	"github.com/render-oss/cli/pkg/dependencies"
@@ -192,9 +193,36 @@ func setupRootCmdPersistentRun(deps *dependencies.Dependencies) {
 	}
 }
 
+// printVersionWithUpdateCheck prints the current version and checks for updates
+func printVersionWithUpdateCheck() {
+	fmt.Printf("render v%s\n", cfg.Version)
+
+	vc := version.NewClient(cfg.RepoURL)
+	newVersion, err := vc.NewVersionAvailable()
+	if err == nil && newVersion != "" {
+		fmt.Println()
+		fmt.Println(lipgloss.NewStyle().Foreground(renderstyle.ColorWarning).
+			Render(fmt.Sprintf("A new version is available: %s\n\nTo upgrade, see: %s",
+				renderstyle.Bold("v"+newVersion),
+				cfg.InstallationInstructionsURL)))
+	} else if err == nil {
+		fmt.Println()
+		fmt.Println(lipgloss.NewStyle().Foreground(renderstyle.ColorOK).
+			Render("You are using the latest 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() {
+	// Check if version flag is explicitly requested before Cobra handles it
+	for _, arg := range os.Args[1:] {
+		if arg == "--version" || arg == "-v" {
+			printVersionWithUpdateCheck()
+			return
+		}
+	}
+
 	if err := SetupCommands(); err != nil {
 		os.Exit(1)
 	}

pkg/cfg/cfg.go

@@ -7,7 +7,7 @@ import (
 )
 
 const RepoURL = "https://api.github.com/repos/render-oss/cli"
-const InstallationInstructionsURL = "https://render.com/docs/cli#1-install"
+const InstallationInstructionsURL = "https://render.com/docs/cli#1-install-or-upgrade"
 
 var Version = "dev"
 var osInfo string