Add Windows CLI install support

Author: iFurySt

.github/workflows/release.yml

@@ -90,6 +90,11 @@ jobs:
             echo "Expected 4 CLI release archives, found ${cli_asset_count}" >&2
             exit 1
           fi
+          windows_cli_asset_count="$(find dist/cli -maxdepth 1 -type f -name '*.zip' | wc -l | tr -d ' ')"
+          if [ "${windows_cli_asset_count}" -ne 2 ]; then
+            echo "Expected 2 Windows CLI release archives, found ${windows_cli_asset_count}" >&2
+            exit 1
+          fi
           chrome_extension_zip="$(find dist/chrome-extension -maxdepth 1 -type f -name '*.zip' -print -quit)"
           if [ -z "${chrome_extension_zip}" ]; then
             echo "Chrome extension zip not found" >&2
@@ -131,6 +136,7 @@ jobs:
             dist/repo-metadata.tgz
             dist/release-manifest.json
             dist/cli/*.tar.gz
+            dist/cli/*.zip
             dist/chrome-extension/*.zip
             dist/chrome-extension/*.crx
             dist/chrome-extension/*.json
@@ -147,6 +153,7 @@ jobs:
             dist/chrome-extension/*.zip
             dist/chrome-extension/*.crx
             dist/cli/*.tar.gz
+            dist/cli/*.zip
             dist/skills/*.zip
             dist/skills/*.skill
 
@@ -158,6 +165,7 @@ jobs:
         run: |
           assets=(
             dist/cli/*.tar.gz
+            dist/cli/*.zip
             dist/chrome-extension/*.zip
             dist/chrome-extension/*.crx
             dist/skills/*.zip

README.md

@@ -26,22 +26,21 @@ https://github.com/user-attachments/assets/bcfba878-f6a8-44b9-b84b-29c7e0285687
 ## Quick Start
 
 ```bash
-brew tap iFurySt/open-browser-use
-brew install open-browser-use
+npm i -g open-browser-use
 open-browser-use setup
 ```
 
 ### Install the CLI
 
 ```bash
-# npm
+# npm (macOS, Linux, Windows)
 npm i -g open-browser-use
 
-# Homebrew
+# Homebrew (macOS, Linux)
 brew tap iFurySt/open-browser-use && brew install open-browser-use
 
 # Upgrade
-brew upgrade open-browser-use
+npm update -g open-browser-use
 ```
 
 ### Set Up Chrome

README.zh-CN.md

@@ -20,21 +20,20 @@ https://github.com/user-attachments/assets/bcfba878-f6a8-44b9-b84b-29c7e0285687
 ## Quick Start
 第一次安装可以无脑运行：
 ```bash
-brew tap iFurySt/open-browser-use
-brew install open-browser-use
+npm i -g open-browser-use
 open-browser-use setup
 ```
 
 ### 安装 CLI
 ```bash
-# npm安装
+# npm安装（macOS、Linux、Windows）
 npm i -g open-browser-use
 
-# Homebrew安装
+# Homebrew安装（macOS、Linux）
 brew tap iFurySt/open-browser-use && brew install open-browser-use
 
 # 升级
-brew upgrade open-browser-use
+npm update -g open-browser-use
 ```
 
 ### 配置 Chrome

apps/chrome-extension/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "name": "Open Browser Use",
   "description": "Open Browser Use Chrome automation extension.",
-  "version": "0.1.36",
+  "version": "0.1.37",
   "icons": {
     "16": "icons/icon-16.png",
     "32": "icons/icon-32.png",

cmd/open-browser-use/main.go

@@ -27,7 +27,7 @@ import (
 	"github.com/spf13/cobra"
 )
 
-const version = "0.1.36"
+const version = "0.1.37"
 const defaultChromeExtensionID = "bgjoihaepiejlfjinojjfgokghnodnhd"
 const defaultCLISessionID = "obu-cli"
 const defaultMCPSessionID = "obu-mcp"
@@ -47,16 +47,24 @@ func main() {
 }
 
 func run(args []string) error {
-	if len(args) > 0 && isNativeMessagingLaunch(args[0]) {
+	if isNativeMessagingLaunch(args) {
 		return runHost(host.DefaultSocketDir, "")
 	}
 	cmd := newRootCommand()
 	cmd.SetArgs(args)
 	return cmd.Execute()
 }
 
-func isNativeMessagingLaunch(arg string) bool {
-	return strings.HasPrefix(arg, "chrome-extension://")
+func isNativeMessagingLaunch(args []string) bool {
+	for _, arg := range args {
+		if strings.HasPrefix(arg, "chrome-extension://") {
+			return true
+		}
+		if runtime.GOOS == "windows" && strings.HasPrefix(arg, "--parent-window=") {
+			return true
+		}
+	}
+	return false
 }
 
 func newRootCommand() *cobra.Command {
@@ -325,6 +333,12 @@ func installNativeManifestForBrowser(extensionID string, binaryPath string, outp
 	if err := os.WriteFile(path, append(payload, '\n'), 0o600); err != nil {
 		return "", err
 	}
+	if outputPath == "" && runtime.GOOS == "windows" {
+		key := `HKCU\Software\Google\Chrome\NativeMessagingHosts\` + host.NativeHostName
+		if err := regAddDefaultString(key, path); err != nil {
+			return "", fmt.Errorf("failed to register native messaging host %q: %w", key, err)
+		}
+	}
 	return path, nil
 }
 
@@ -892,6 +906,12 @@ func defaultChromeUserDataDir() (string, error) {
 		return filepath.Join(home, "Library/Application Support/Google/Chrome"), nil
 	case "linux":
 		return filepath.Join(home, ".config/google-chrome"), nil
+	case "windows":
+		localAppData := os.Getenv("LOCALAPPDATA")
+		if strings.TrimSpace(localAppData) == "" {
+			localAppData = filepath.Join(home, "AppData", "Local")
+		}
+		return filepath.Join(localAppData, "Google", "Chrome", "User Data"), nil
 	default:
 		return "", fmt.Errorf("Chrome extension detection is not implemented for %s", runtime.GOOS)
 	}
@@ -1033,6 +1053,13 @@ func installChromeExternalExtensionForBrowser(extensionID string, outputPath str
 	if allowedExtensionID == "" {
 		allowedExtensionID = defaultChromeExtensionID
 	}
+	if runtime.GOOS == "windows" && outputPath == "" {
+		key := `HKCU\Software\Google\Chrome\Extensions\` + allowedExtensionID
+		if err := regAddString(key, "update_url", chromeWebStoreUpdateURL); err != nil {
+			return "", fmt.Errorf("failed to register Chrome external extension %q: %w", key, err)
+		}
+		return "registry:" + key, nil
+	}
 	path := outputPath
 	if path == "" {
 		var err error
@@ -1521,6 +1548,23 @@ func supportedBrowserProfileRoots() ([]browserProfileRoot, error) {
 			BrowserName: "Google Chrome",
 			Root:        filepath.Join(home, ".config/google-chrome"),
 		}}, nil
+	case "windows":
+		localAppData := os.Getenv("LOCALAPPDATA")
+		if strings.TrimSpace(localAppData) == "" {
+			localAppData = filepath.Join(home, "AppData", "Local")
+		}
+		return []browserProfileRoot{
+			{
+				BrowserID:   "chrome",
+				BrowserName: "Google Chrome",
+				Root:        filepath.Join(localAppData, "Google", "Chrome", "User Data"),
+			},
+			{
+				BrowserID:   "chrome-beta",
+				BrowserName: "Google Chrome Beta",
+				Root:        filepath.Join(localAppData, "Google", "Chrome Beta", "User Data"),
+			},
+		}, nil
 	default:
 		return nil, fmt.Errorf("browser profile detection is not implemented for %s", runtime.GOOS)
 	}
@@ -2728,7 +2772,7 @@ func resolveNativeHostTarget(binaryPath string) (string, error) {
 	if info.IsDir() {
 		return "", fmt.Errorf("native host binary target is a directory: %s", absolutePath)
 	}
-	if info.Mode()&0o111 == 0 {
+	if runtime.GOOS != "windows" && info.Mode()&0o111 == 0 {
 		return "", fmt.Errorf("native host binary target is not executable: %s", absolutePath)
 	}
 	return absolutePath, nil
@@ -2744,6 +2788,12 @@ func stableNativeHostPath() (string, error) {
 		return filepath.Join(home, "Library/Application Support/OpenBrowserUse/native-host/open-browser-use"), nil
 	case "linux":
 		return filepath.Join(home, ".local/share/open-browser-use/native-host/open-browser-use"), nil
+	case "windows":
+		localAppData := os.Getenv("LOCALAPPDATA")
+		if strings.TrimSpace(localAppData) == "" {
+			localAppData = filepath.Join(home, "AppData", "Local")
+		}
+		return filepath.Join(localAppData, "OpenBrowserUse", "native-host", "open-browser-use.exe"), nil
 	default:
 		return "", fmt.Errorf("stable native host link path is not implemented for %s", runtime.GOOS)
 	}
@@ -2770,6 +2820,11 @@ func defaultChromeExternalExtensionPathForBrowser(extensionID string, browserSel
 		return filepath.Join(root.Root, "External Extensions", filename), nil
 	case "linux":
 		return filepath.Join("/opt/google/chrome/extensions", filename), nil
+	case "windows":
+		if strings.TrimSpace(browserSelector) != "" && !browserSelectorMatches(browserSelector, connectedProfileInfo{Browser: "chrome", BrowserName: "Google Chrome"}) {
+			return "", fmt.Errorf("Chrome external extension setup is not implemented for browser selector %q on %s", browserSelector, runtime.GOOS)
+		}
+		return `HKCU\Software\Google\Chrome\Extensions\` + strings.TrimSpace(extensionID), nil
 	default:
 		return "", fmt.Errorf("Chrome external extension setup is not implemented for %s", runtime.GOOS)
 	}
@@ -2779,12 +2834,45 @@ func installStableNativeHostLink(targetPath string, linkPath string) error {
 	if err := os.MkdirAll(filepath.Dir(linkPath), 0o700); err != nil {
 		return err
 	}
+	if runtime.GOOS == "windows" {
+		if samePath(targetPath, linkPath) {
+			return nil
+		}
+		return copyFile(targetPath, linkPath, 0o700)
+	}
 	if err := os.Remove(linkPath); err != nil && !errors.Is(err, os.ErrNotExist) {
 		return err
 	}
 	return os.Symlink(targetPath, linkPath)
 }
 
+func samePath(left string, right string) bool {
+	leftAbs, leftErr := filepath.Abs(left)
+	rightAbs, rightErr := filepath.Abs(right)
+	if leftErr != nil || rightErr != nil {
+		return false
+	}
+	return strings.EqualFold(filepath.Clean(leftAbs), filepath.Clean(rightAbs))
+}
+
+func copyFile(sourcePath string, targetPath string, mode os.FileMode) error {
+	source, err := os.Open(sourcePath)
+	if err != nil {
+		return err
+	}
+	defer source.Close()
+	target, err := os.OpenFile(targetPath, os.O_CREATE|os.O_TRUNC|os.O_WRONLY, mode)
+	if err != nil {
+		return err
+	}
+	_, copyErr := io.Copy(target, source)
+	closeErr := target.Close()
+	if copyErr != nil {
+		return copyErr
+	}
+	return closeErr
+}
+
 func defaultNativeHostManifestPath() (string, error) {
 	return defaultNativeHostManifestPathForBrowser("")
 }
@@ -2804,6 +2892,12 @@ func defaultNativeHostManifestPathForBrowser(browserSelector string) (string, er
 		return filepath.Join(root.Root, "NativeMessagingHosts", filename), nil
 	case "linux":
 		return filepath.Join(home, ".config/google-chrome/NativeMessagingHosts", filename), nil
+	case "windows":
+		localAppData := os.Getenv("LOCALAPPDATA")
+		if strings.TrimSpace(localAppData) == "" {
+			localAppData = filepath.Join(home, "AppData", "Local")
+		}
+		return filepath.Join(localAppData, "OpenBrowserUse", "NativeMessagingHosts", filename), nil
 	default:
 		return "", fmt.Errorf("default manifest install path is not implemented for %s; pass --output", runtime.GOOS)
 	}
@@ -3019,6 +3113,12 @@ func defaultUnpackedExtensionDir() (string, error) {
 		return filepath.Join(home, "Library/Application Support/OpenBrowserUse/chrome-extension/release"), nil
 	case "linux":
 		return filepath.Join(home, ".local/share/open-browser-use/chrome-extension/release"), nil
+	case "windows":
+		localAppData := os.Getenv("LOCALAPPDATA")
+		if strings.TrimSpace(localAppData) == "" {
+			localAppData = filepath.Join(home, "AppData", "Local")
+		}
+		return filepath.Join(localAppData, "OpenBrowserUse", "chrome-extension", "release"), nil
 	default:
 		return "", fmt.Errorf("release extension setup is not implemented for %s", runtime.GOOS)
 	}
@@ -3254,6 +3354,8 @@ func openChromeExtensionsPage() error {
 		cmd = exec.Command("open", "-a", "Google Chrome", "chrome://extensions/")
 	case "linux":
 		cmd = exec.Command("xdg-open", "chrome://extensions/")
+	case "windows":
+		cmd = exec.Command("rundll32", "url.dll,FileProtocolHandler", "chrome://extensions/")
 	default:
 		return fmt.Errorf("opening Chrome extensions page is not implemented for %s", runtime.GOOS)
 	}
@@ -3281,6 +3383,28 @@ func openChromeWebStorePage() error {
 	return cmd.Process.Release()
 }
 
+func regAddDefaultString(key string, value string) error {
+	return regAddString(key, "", value)
+}
+
+func regAddString(key string, name string, value string) error {
+	if runtime.GOOS != "windows" {
+		return fmt.Errorf("registry setup is not implemented for %s", runtime.GOOS)
+	}
+	args := []string{"ADD", key}
+	if strings.TrimSpace(name) == "" {
+		args = append(args, "/ve")
+	} else {
+		args = append(args, "/v", name)
+	}
+	args = append(args, "/t", "REG_SZ", "/d", value, "/f")
+	output, err := exec.Command("reg.exe", args...).CombinedOutput()
+	if err != nil {
+		return fmt.Errorf("%w: %s", err, strings.TrimSpace(string(output)))
+	}
+	return nil
+}
+
 func numberAsInt(value any) (int, bool) {
 	switch typed := value.(type) {
 	case int:

cmd/open-browser-use/main_test.go

@@ -29,10 +29,13 @@ func TestNativeHostNameIsChromeCompatible(t *testing.T) {
 }
 
 func TestNativeMessagingLaunchArg(t *testing.T) {
-	if !isNativeMessagingLaunch("chrome-extension://nfjjgckfgejeofdcmaepbapclmldcflf/") {
+	if !isNativeMessagingLaunch([]string{"--parent-window=123", "chrome-extension://nfjjgckfgejeofdcmaepbapclmldcflf/"}) {
 		t.Fatal("expected Chrome extension origin to launch host mode")
 	}
-	if isNativeMessagingLaunch("host") {
+	if runtime.GOOS == "windows" && !isNativeMessagingLaunch([]string{"--parent-window=123"}) {
+		t.Fatal("expected Windows parent window arg to launch host mode")
+	}
+	if isNativeMessagingLaunch([]string{"host"}) {
 		t.Fatal("expected CLI subcommand not to be treated as native messaging launch")
 	}
 }