Open store page during setup

Author: iFurySt

README.md

@@ -46,8 +46,9 @@ brew upgrade open-browser-use
 
 ### Set Up Chrome
 
-Register the native host for the extension, then install the matching Chrome
-extension.
+Register the native host for the extension. The setup command also opens the
+Chrome Web Store page so you can install or enable the matching Chrome
+extension, then restart Chrome if needed.
 
 ```bash
 open-browser-use setup

README.zh-CN.md

@@ -38,7 +38,8 @@ brew upgrade open-browser-use
 ```
 
 ### 配置 Chrome
-注册绑定到该插件的 native host，然后安装对应的浏览器插件
+注册绑定到该插件的 native host。setup 也会打开 Chrome Web Store 页面，你需要在
+页面里安装或启用对应的浏览器插件，必要时再重启 Chrome。
 
 ```bash
 open-browser-use setup

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.34",
+  "version": "0.1.35",
   "icons": {
     "16": "icons/icon-16.png",
     "32": "icons/icon-32.png",

cmd/open-browser-use/main.go

@@ -26,11 +26,12 @@ import (
 	"github.com/spf13/cobra"
 )
 
-const version = "0.1.34"
+const version = "0.1.35"
 const defaultChromeExtensionID = "bgjoihaepiejlfjinojjfgokghnodnhd"
 const defaultCLISessionID = "obu-cli"
 const defaultMCPSessionID = "obu-mcp"
 const chromeWebStoreUpdateURL = "https://clients2.google.com/service/update2/crx"
+const chromeWebStoreExtensionURL = "https://chromewebstore.google.com/detail/open-browser-use/" + defaultChromeExtensionID + "?utm_source=open-computer-use"
 const betaExtensionPublicKey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnBLT95WWVnHYH0pOBRH/eP+BWtlKVmLE/RHkERUTI2+PGDSQrbWVabmTw4CZ3yhjko04dijSX2Az8cnp65xh23Dh5mP5TCtiP9LexRFJokd8EsyeFdtKamMYr0hF1ZUc1/8ZpLnetAU65ZMB9VzHQBqpJWeUwuIvecgfRtGklDgJMjnvcq5J6pttZrzWrI/2B0BNufwsTQfEt7qLtDFPHXmUdtZfQbc2EfYFvkXLDAXicYviiocedrsAGIKUxpyQegobhUFL+tNLOuXKBpZlLFQn3xgm5CyGZwN6bueiV/S7reigVTKAMQ8BX0eacT22e8r0UzjsjkugeHOIonIvtQIDAQAB"
 
 func main() {
@@ -125,6 +126,7 @@ func newSetupCommand() *cobra.Command {
 	extensionID := defaultChromeExtensionID
 	var binaryPath string
 	var externalExtensionOutput string
+	var noOpen bool
 	cmd := &cobra.Command{
 		Use:   "setup",
 		Short: "Register Chrome integration for Open Browser Use",
@@ -134,13 +136,21 @@ func newSetupCommand() *cobra.Command {
 			if err != nil {
 				return err
 			}
+			if !noOpen {
+				if err := openChromeWebStorePage(); err != nil {
+					result.StoreOpenError = err.Error()
+				} else {
+					result.OpenedStore = true
+				}
+			}
 			status := detectBrowserExtension(host.DefaultSocketDir, 700*time.Millisecond)
 			return renderStoreSetupResult(cmd.OutOrStdout(), result, status)
 		},
 	}
 	cmd.Flags().StringVar(&extensionID, "extension-id", defaultChromeExtensionID, "Chrome extension id for allowed_origins")
 	cmd.Flags().StringVar(&binaryPath, "path", "", "native host binary target for the stable host link")
 	cmd.Flags().StringVar(&externalExtensionOutput, "external-extension-output", "", "Chrome external extension JSON output path")
+	cmd.Flags().BoolVar(&noOpen, "no-open", false, "register Chrome integration without opening the Chrome Web Store page")
 	cmd.AddCommand(newSetupBetaCommand())
 	return cmd
 }
@@ -298,6 +308,9 @@ func installNativeManifest(extensionID string, binaryPath string, outputPath str
 type setupResult struct {
 	NativeManifestPath    string
 	ExternalExtensionPath string
+	StoreURL              string
+	OpenedStore           bool
+	StoreOpenError        string
 }
 
 type manualSetupResult struct {
@@ -333,6 +346,7 @@ func setupChrome(extensionID string, binaryPath string, externalExtensionOutput
 	return setupResult{
 		NativeManifestPath:    manifestPath,
 		ExternalExtensionPath: extensionPath,
+		StoreURL:              chromeWebStoreExtensionURL,
 	}, nil
 }
 
@@ -369,7 +383,14 @@ func renderStoreSetupResult(writer io.Writer, result setupResult, status browser
 	fmt.Fprintln(writer, "✅ Open Browser Use setup")
 	fmt.Fprintf(writer, "1. ✅ Registered native host\n   %s\n", result.NativeManifestPath)
 	fmt.Fprintf(writer, "2. ✅ Requested Chrome extension install\n   Extension id: %s\n   Chrome install file: %s\n", defaultChromeExtensionID, result.ExternalExtensionPath)
-	fmt.Fprintf(writer, "3. 🧩 Browser extension\n   %s\n", status.summaryForSetup("Not installed yet. Chrome still needs to install or enable it."))
+	if result.OpenedStore {
+		fmt.Fprintf(writer, "3. ✅ Opened Chrome Web Store\n   %s\n", result.StoreURL)
+	} else if result.StoreOpenError != "" {
+		fmt.Fprintf(writer, "3. ⚠️ Chrome Web Store page was not opened\n   %s\n   Error: %s\n", result.StoreURL, result.StoreOpenError)
+	} else {
+		fmt.Fprintf(writer, "3. Open Chrome Web Store\n   %s\n", result.StoreURL)
+	}
+	fmt.Fprintf(writer, "4. 🧩 Browser extension\n   %s\n", status.summaryForSetup("Not installed yet. Install or enable it from the Chrome Web Store page."))
 	fmt.Fprintln(writer)
 	if status.isReady() {
 		fmt.Fprintln(writer, "All set. The browser extension is installed, connected, and on the expected version.")
@@ -380,8 +401,8 @@ func renderStoreSetupResult(writer io.Writer, result setupResult, status browser
 		return nil
 	}
 	fmt.Fprintln(writer, "Next:")
-	fmt.Fprintln(writer, "  1. Restart Chrome if it is already open.")
-	fmt.Fprintln(writer, "  2. Approve or enable the Open Browser Use extension if Chrome asks.")
+	fmt.Fprintln(writer, "  1. Install or enable Open Browser Use from the Chrome Web Store page.")
+	fmt.Fprintln(writer, "  2. Restart Chrome if Chrome asks or the extension does not appear immediately.")
 	fmt.Fprintln(writer, "  3. Verify the connection: open-browser-use info")
 	return nil
 }
@@ -2303,6 +2324,24 @@ func openChromeExtensionsPage() error {
 	return cmd.Process.Release()
 }
 
+func openChromeWebStorePage() error {
+	var cmd *exec.Cmd
+	switch runtime.GOOS {
+	case "darwin":
+		cmd = exec.Command("open", "-a", "Google Chrome", chromeWebStoreExtensionURL)
+	case "linux":
+		cmd = exec.Command("xdg-open", chromeWebStoreExtensionURL)
+	case "windows":
+		cmd = exec.Command("rundll32", "url.dll,FileProtocolHandler", chromeWebStoreExtensionURL)
+	default:
+		return fmt.Errorf("opening Chrome Web Store is not implemented for %s", runtime.GOOS)
+	}
+	if err := cmd.Start(); err != nil {
+		return err
+	}
+	return cmd.Process.Release()
+}
+
 func numberAsInt(value any) (int, bool) {
 	switch typed := value.(type) {
 	case int:

cmd/open-browser-use/main_test.go

@@ -222,7 +222,7 @@ func TestCobraSetupWritesNativeAndExternalManifests(t *testing.T) {
 	cmd := newRootCommand()
 	var output bytes.Buffer
 	cmd.SetOut(&output)
-	cmd.SetArgs([]string{"setup", "--path", targetPath, "--external-extension-output", externalPath})
+	cmd.SetArgs([]string{"setup", "--path", targetPath, "--external-extension-output", externalPath, "--no-open"})
 	if err := cmd.Execute(); err != nil {
 		t.Fatal(err)
 	}
@@ -235,6 +235,9 @@ func TestCobraSetupWritesNativeAndExternalManifests(t *testing.T) {
 	if !strings.Contains(output.String(), "Browser extension") {
 		t.Fatalf("expected setup output to mention browser extension status, got %q", output.String())
 	}
+	if !strings.Contains(output.String(), chromeWebStoreExtensionURL) {
+		t.Fatalf("expected setup output to mention Chrome Web Store URL, got %q", output.String())
+	}
 	if _, err := os.Stat(filepath.Join(home, "Library/Application Support/Google/Chrome/NativeMessagingHosts", host.NativeHostName+".json")); runtime.GOOS == "darwin" && err != nil {
 		t.Fatal(err)
 	}

docs/ARCHITECTURE.md

@@ -96,9 +96,10 @@ dot；hyphen 版本 `com.ifuryst.open-computer-use.extension` 会被
   写入 Chrome 默认位置，或通过 `--output` 写到指定路径。默认 extension id
   是 Chrome Web Store 版 `bgjoihaepiejlfjinojjfgokghnodnhd`。
 - `open-browser-use setup`：显式安装流程，先调用 native host manifest
-  注册，再写入 Chrome External Extensions JSON，让 Chrome 从 Web Store
-  安装正式扩展。macOS/Windows 仍需要用户在 Chrome 中确认启用扩展；Linux
-  的 External Extensions 写入默认使用 Chrome 官方系统路径，可能需要更高权限。
+  注册，再写入 Chrome External Extensions JSON，并打开 Chrome Web Store
+  正式扩展页，引导用户手动安装或启用扩展。macOS/Windows 仍可能需要用户在
+  Chrome 中确认启用扩展并重启；Linux 的 External Extensions 写入默认使用
+  Chrome 官方系统路径，可能需要更高权限。
 - `open-browser-use setup beta`：Chrome Web Store 临时不可用时的备用路径，
   注册 native host 后从 GitHub Releases 下载最新
   `open-browser-use-chrome-extension-*.zip`。CLI 会在本地 unpacked 目录和待拖入

docs/CHROME_WEB_STORE_LISTING.md

@@ -115,8 +115,9 @@ short in the Dashboard if character limits apply.
 
 The Chrome Web Store package contains only the MV3 extension. Users must install
 the native host separately through npm or Homebrew. After installing the CLI,
-users run setup to register the native host and the Chrome Web Store extension
-install hint for extension `bgjoihaepiejlfjinojjfgokghnodnhd`.
+users run setup to register the native host, write the Chrome Web Store
+extension install hint for extension `bgjoihaepiejlfjinojjfgokghnodnhd`, and
+open the store page so the user can install or enable the extension.
 
 Recommended setup command:
 

docs/CHROME_WEB_STORE_RELEASE.md

@@ -17,9 +17,9 @@ Chrome extension 不能自己安装 native messaging host manifest。正式扩
 open-browser-use setup
 ```
 
-`setup` 会调用 native host manifest 注册，并写入 Chrome External Extensions
-JSON，让 Chrome 从 Chrome Web Store 安装正式扩展；用户仍可能需要重启 Chrome
-并确认启用扩展。需要只修复 native host 时，仍可运行：
+`setup` 会调用 native host manifest 注册，写入 Chrome External Extensions
+JSON，并打开 Chrome Web Store 正式扩展页。用户需要在商店页手动安装或启用扩展；
+Chrome 仍可能要求用户重启并确认启用扩展。需要只修复 native host 时，仍可运行：
 
 ```bash
 open-browser-use install-manifest

docs/histories/2026-05/20260511-1931-guided-store-setup.md

@@ -0,0 +1,45 @@
+## [2026-05-11 19:31] | Task: guided store setup
+
+### 🤖 Execution Context
+
+- **Agent ID**: `Codex`
+- **Base Model**: `GPT-5`
+- **Runtime**: `Codex CLI`
+
+### 📥 User Query
+
+> 希望 `setup` 时打开 Open Browser Use 的 Chrome Web Store 页面，让用户自己安装和重启。
+
+### 🛠 Changes Overview
+
+**Scope:** CLI setup flow, install docs, release notes.
+
+**Key Actions:**
+
+- **[CLI]**: `open-browser-use setup` now opens the public Chrome Web Store listing after registering the native host and writing the External Extensions hint.
+- **[Automation Escape Hatch]**: Added `setup --no-open` for tests, CI, and headless environments that should only write setup files.
+- **[Release]**: Bumped Open Browser Use runtime/package versions from `0.1.34` to `0.1.35`.
+- **[Docs]**: Updated README, npm package README, Chrome Web Store release/listing docs, bundled skill installation reference, and feature release notes.
+
+### 🧠 Design Intent (Why)
+
+Chrome's external extension hint can be delayed until Chrome restart and does not give the user a visible place to act. Opening the store listing makes the remaining human step explicit while keeping native host registration repeatable from the CLI.
+
+### 📁 Files Modified
+
+- `cmd/open-browser-use/main.go`
+- `cmd/open-browser-use/main_test.go`
+- `apps/chrome-extension/manifest.json`
+- `packages/open-browser-use-cli/package.json`
+- `packages/open-browser-use-js/package.json`
+- `packages/open-browser-use-python/pyproject.toml`
+- `packages/browser-use-protocol/package.json`
+- `packages/browser-client-rewrite/package.json`
+- `README.md`
+- `README.zh-CN.md`
+- `packages/open-browser-use-cli/README.md`
+- `docs/ARCHITECTURE.md`
+- `docs/CHROME_WEB_STORE_RELEASE.md`
+- `docs/CHROME_WEB_STORE_LISTING.md`
+- `docs/releases/feature-release-notes.md`
+- `skills/open-browser-use/references/installation.md`

docs/releases/feature-release-notes.md

@@ -4,6 +4,7 @@
 
 | 日期 | 功能域 | 用户价值 | 变更摘要 |
 | --- | --- | --- | --- |
+| 2026-05-11 | Guided Store Setup | `open-browser-use setup` 会直接打开 Open Browser Use 的 Chrome Web Store 页面，用户可以在明确的页面里安装或启用扩展并按需重启。 | 发布 `0.1.35` patch 版本，setup 仍会注册 native host 和写入 External Extensions hint，同时新增 `--no-open` 供 CI、测试或无桌面环境只写配置。 |
 | 2026-05-11 | Chrome Extension Popup | 高分辨率屏幕上 popup 顶部 LOGO 更清晰，不再因为用 32px 位图放大显示而出现明显锯齿。 | 发布 `0.1.34` patch 版本，popup 头部改用 128px icon 作为源图并保持 32 CSS px 显示尺寸；同步 runtime、SDK、extension 版本号和发布制品。 |
 | 2026-05-11 | Chrome Extension Logo | Chrome Web Store 和浏览器工具栏会显示新版 Open Browser Use 标识，减少旧视觉资产和当前品牌方向不一致的问题。 | 发布 `0.1.33` patch 版本，替换 Chrome extension 的 16/32/48/128 PNG icons 和 1024px source logo，并沿用现有 tag release 与 Chrome Web Store 自动提交链路。 |
 | 2026-05-11 | Chrome Web Store Release Drill | 维护者可以用 `v0.1.32` 验证 tag release 到 Chrome Web Store 自动提交审核的完整链路。 | 发布 `0.1.32` patch 版本，用新配置的 `CWS_SERVICE_ACCOUNT_JSON`、publisher/extension secrets 和 `CWS_AUTO_PUBLISH=true` 触发真实 CWS 上传与提交流程。 |