@agent360/browser-mcp 1.25.0 → 1.28.1

package/README.md

@@ -17,17 +17,47 @@ Browser MCP gives Claude Code (and any MCP client — Cursor, VS Code agent mode
 
 The killer move: it hits a login wall, reads the verification code from your own Gmail tab, and continues the sign-in. No API can do that. Operate platforms with no API, QA your own web app end-to-end, or work dashboards, LinkedIn and Reddit at human pace — with you approving the sensitive steps.
 
-34 tools. Auto-clicks the reCAPTCHA v2 checkbox, with a human fallback for the rest. Multi-session color-coded tab groups. **MIT, free, and 100% local — nothing leaves your machine.**
+40 tools. Auto-clicks the reCAPTCHA v2 checkbox, with a human fallback for the rest. Multi-session color-coded tab groups. **MIT, free, and 100% local — nothing leaves your machine.**
 
-## Install — 2 steps (~60 seconds)
+## The whole thing, in four steps
 
-### Step 1: Configure the MCP server
+**1 — Install the Chrome extension.** One click from the [Chrome Web Store](https://chromewebstore.google.com/detail/agent360-browser-mcp/jdehgalffmffhfhmmhaokfbfnafnmgcl); Chrome keeps it updated. No store? See the unpacked install below.
+
+**2 — Add the MCP server.** Paste this in a terminal. Required — the extension does nothing on its own:
+
+```bash
+claude mcp add --scope user browser-mcp -- npx @agent360/browser-mcp@latest
+```
+
+**3 — Restart Claude Code.** That is what starts the server. The extension icon turns green.
+
+**4 — Say this, to check it worked.** Paste it to Claude Code:
+
+> Take a screenshot of my current Chrome tab.
+
+You get an image back instead of *"I don't have browser access"*. **That's it — you're running.** → [What else to say](#youre-in-now-what)
+
+Using Cursor, VS Code, Codex or Windsurf? Same server, that client's own config — see [browsermcp.dev/docs](https://browsermcp.dev/docs/install-cursor/). Everything below is the long version.
+
+## The long version — install, step by step
+
+> **Browser MCP is two halves and you need both:** a **Chrome extension** (drives the browser) and a **local MCP server** (what your agent actually talks to). Installing only the extension — e.g. straight from the Chrome Web Store — leaves it stuck on *"Not connected"*, because there is no server for it to reach. Chrome cannot install the server, and npm cannot install the extension. Hence two steps.
+
+### Step 1: Register the MCP server with Claude Code
+
+```bash
+claude mcp add --scope user browser-mcp -- npx @agent360/browser-mcp@latest
+```
+
+That is Claude Code's own MCP command, so the entry lands in the config Claude Code actually reads. `--scope user` makes it available in every project.
+
+Want the extension files on disk for the unpacked install in Step 2? Also run:
 
 ```bash
 npx @agent360/browser-mcp install
 ```
 
-This copies the Chrome extension files to `~/.browser-mcp/extension/` and adds the MCP server to your Claude Code config. **You'll see the path to the extension folder printed in the terminal — copy it.**
+It copies the extension to `~/.browser-mcp/extension/` and **prints that path in the terminal — copy it.** (Use it for the extension files only; register the server with `claude mcp add` above.)
 
 ### Step 2: Load the extension in Chrome
 
@@ -42,49 +72,84 @@ This copies the Chrome extension files to `~/.browser-mcp/extension/` and adds t
    - On Linux: Type `~/.browser-mcp/extension/` in the path field
 5. **Restart Claude Code** so it picks up the new MCP server
 
-That's it. The Browser MCP icon will appear in your toolbar, and 34 browser tools are now available in Claude Code.
+That's it. The Browser MCP icon will appear in your toolbar, and 40 browser tools are now available in Claude Code.
 
 ### Alternative: Manual zip download (no npm)
 
 If you don't want to use npm, download the extension directly:
 
-1. [Download `browser-mcp-v1.25.0.zip`](https://github.com/Agent360dk/browser-mcp/releases/latest) from the latest GitHub release
+1. [Download the extension zip](https://github.com/Agent360dk/browser-mcp/releases/latest) (`agent360-browser-mcp-<version>.zip`) from the latest GitHub release
 2. Unzip the file (anywhere — e.g. `~/Downloads/browser-mcp-extension/`)
 3. Follow Step 2 above, but select the unzipped folder instead of `~/.browser-mcp/extension/`
-4. Configure Claude Code manually by adding this to your `~/.claude.json` (or run `npx @agent360/browser-mcp install --skip-extension`):
+4. Register the server — run `claude mcp add --scope user browser-mcp -- npx @agent360/browser-mcp@latest`, or add this to `~/.claude.json` by hand:
    ```json
    {
      "mcpServers": {
        "browser-mcp": {
          "command": "npx",
-         "args": ["@agent360/browser-mcp"]
+         "args": ["@agent360/browser-mcp@latest"]
        }
      }
    }
    ```
 
-### Chrome Web Store (one-click install)
+### Chrome Web Store (no Developer mode, auto-updating extension)
+
+**This replaces Step 2 only — you still need Step 1.**
+
+1. [**Install the extension from the Chrome Web Store →**](https://chromewebstore.google.com/detail/agent360-browser-mcp/jdehgalffmffhfhmmhaokfbfnafnmgcl) — no Developer mode toggle, and Chrome keeps it updated for you.
+2. Register the MCP server:
+   ```bash
+   claude mcp add --scope user browser-mcp -- npx @agent360/browser-mcp@latest
+   ```
+   (For Cursor / VS Code / Codex, use that client's own MCP config instead — see [browsermcp.dev/docs](https://browsermcp.dev/docs/install-claude-code/).)
+3. Restart Claude Code.
+
+Skip step 2 and the extension icon will sit on **"Not connected"** forever — that is the symptom of a missing MCP server, not a broken extension.
+
+## You're in. Now what?
+
+Nothing happens until you ask, and the hardest part of a new tool is knowing what to ask for. Paste one of these to your agent:
 
-[**Install from Chrome Web Store →**](https://chromewebstore.google.com/detail/agent360-browser-mcp/jdehgalffmffhfhmmhaokfbfnafnmgcl)
+| Say this | What it shows |
+|---|---|
+| *"Take a screenshot of my current Chrome tab."* | **Start here.** An image back instead of *"I don't have browser access"* means both halves are talking. That is the whole install test. |
+| *"Open my Gmail tab and tell me who sent my last 3 emails."* | The one that shows the difference — it works because it is *your* browser, already signed in. A headless tool hits a login wall here. |
+| *"Go to my analytics dashboard, pull this month's numbers, and put them in a table."* | Any dashboard you are already logged into. No API key, no export, no integration to build first. |
+| *"Fill in this signup form with my details. Stop and ask me before anything sensitive."* | You stay in the loop — it hands control back for passwords, payment details, or anything it should not decide alone. |
+| *"Log me in here. If it emails a code, read it from my Gmail tab and continue."* | The move no API can make: it reads the one-time code out of your own inbox and finishes the sign-in. |
+| *"Walk through my app's signup flow as a real user and tell me where it breaks."* | End-to-end QA of your own product, in the same browser your users have. |
 
-No Developer mode needed. Then run `npx @agent360/browser-mcp install --skip-extension` to configure Claude Code.
+The pattern: **anything you would do yourself in a browser, on a site you are already signed into.** It is strongest where there is no API — internal dashboards, admin panels, portals, LinkedIn. Built something good? [Add it to the gallery](USE_CASES.md).
 
 ## Why This Over Playwright MCP / BrowserMCP?
 
 | | Browser MCP | Playwright MCP | BrowserMCP.io |
 |---|---|---|---|
 | **Browser** | Your real Chrome | Headless (new session) | Your real Chrome |
+| **Maintained** | Actively — latest release v1.25.0 (2026-07-24) | Actively (Microsoft) | Last commit Apr 2025 |
 | **Logins/cookies** | Already authenticated | Must log in every time | Already authenticated |
-| **Multi-session** | 10 concurrent sessions with color-coded tab groups | Single session | Single session |
+| **Multi-session** | 20 concurrent sessions with color-coded tab groups | Single session | Single session |
 | **Human-in-the-loop** | `browser_ask_user` — 2FA, CAPTCHA, credential input | None | None |
 | **Provider integrations** | 9 built-in (Stripe, HubSpot, Slack...) | None | None |
 | **CORS bypass** | `browser_fetch` from extension background | N/A | Limited |
 | **Network monitoring** | `browser_wait_for_network` via CDP | Built-in | None |
 | **CSP-strict sites** | Chrome Debugger API throughout | Works (headless) | Limited |
 | **Custom dropdowns** | Angular Material, React Select support | Works (headless) | Limited |
-| **Install** | `npx @agent360/browser-mcp install` | `npx @anthropic-ai/mcp-playwright` | Manual clone |
+| **Install** | `claude mcp add` + extension from the Chrome Web Store | `npx @playwright/mcp` | Manual clone |
 
-## 34 Tools
+> **On the name:** the similarly-named `browsermcp.io` (`@browsermcp/mcp`) is a different, unaffiliated project with no commits since April 2025. This is Browser MCP by Agent360 (`@agent360/browser-mcp`) — actively maintained. [Full side-by-side →](https://browsermcp.dev/compare/browsermcp-io/)
+
+### Environment variables
+
+Both are optional. Neither is needed for normal use.
+
+| Variable | Effect |
+|---|---|
+| `BROWSER_MCP_CHECK_NPM=1` | Makes `browser_provide_feedback` also compare this server against the latest version published on npm. Off by default, so the call stays fast and works offline. |
+| `BROWSER_MCP_EXTENSION_ID=<32-char id>` | Pins the server to one specific Chrome extension. Use it when more than one copy of Browser MCP is loaded and you want a given session to always talk to the same one. |
+
+## 40 Tools
 
 ### Navigation & Content
 | Tool | Description |
@@ -93,6 +158,7 @@ No Developer mode needed. Then run `npx @agent360/browser-mcp install --skip-ext
 | `browser_get_page_content` | Get page text or HTML |
 | `browser_screenshot` | Screenshot via Chrome Debugger (works even when tab isn't focused) |
 | `browser_execute_script` | Run JavaScript in page context |
+| `browser_extract_list` | Read every row of a long/virtualised list by scrolling its container until no new rows appear |
 
 ### Interaction
 | Tool | Description |
@@ -108,6 +174,10 @@ No Developer mode needed. Then run `npx @agent360/browser-mcp install --skip-ext
 | `browser_set_date` | Robust date inputs: tries native value-set → masked typing → calendar-picker navigation (MUI/AntD/react-datepicker/Lexical). Use when `browser_fill` fails on date fields |
 | `browser_dismiss_overlays` | Bulk-dismiss popups/modals/tooltips/banners via aria-label/text/×-char heuristics. `non_critical` mode preserves dialogs with form data |
 | `browser_handle_dialog` | Accept/dismiss native alert/confirm/prompt dialogs |
+| `browser_double_click` | True double-click (two trusted press/release pairs) |
+| `browser_right_click` | Right-click to open page-level context menus |
+| `browser_click_xy` | Escape hatch: click at raw viewport coordinates (CSS pixels) with trusted mouse events |
+| `browser_reattach_debugger` | Recovery: force-detach and re-attach the Chrome debugger on the current tab |
 
 ### Tabs & Frames
 | Tool | Description |
@@ -122,8 +192,6 @@ No Developer mode needed. Then run `npx @agent360/browser-mcp install --skip-ext
 ### Data & Network
 | Tool | Description |
 |------|-------------|
-| `browser_get_cookies` | Get cookies for domain |
-| `browser_get_local_storage` | Read localStorage |
 | `browser_fetch` | HTTP request from extension (bypasses CORS) |
 | `browser_wait_for_network` | Wait for specific API call to complete |
 | `browser_extract_token` | Navigate to provider dashboard + extract API token |
@@ -149,9 +217,15 @@ No Developer mode needed. Then run `npx @agent360/browser-mcp install --skip-ext
 | `browser_upload_file` | Upload files to `<input type="file">` via Chrome Debugger API (no dialog) |
 | `browser_drop_file` | Upload via drop-zones: finds hidden `<input type="file">` in target subtree/parent (up to 2 levels). Use when `browser_upload_file` fails because the zone has no visible input |
 
+### Diagnostics & feedback
+| Tool | Description |
+|------|-------------|
+| `browser_provide_feedback` | Self-check + report in one call. Compares this server against the latest on npm, the connected extension against this server, and detects **more than one Browser MCP extension connected at once** — the three things that explain most "it just stopped working" moments. Returns a verdict (`current` / `outdated` / `conflict` / `disconnected`), concrete fix steps, and a pre-filled issue link for whatever is genuinely missing. Your agent calls it on its own whenever a tool blocks it |
+| `browser_about` | Project info + pre-filled links to submit a wish, use-case, or bug |
+
 ## Multi-Session Support
 
-Each Claude Code conversation gets its own MCP server on a unique port (9876-9885). The Chrome extension connects to all active servers simultaneously.
+Each Claude Code conversation gets its own MCP server on a unique port (9876-9895). The Chrome extension connects to all active servers simultaneously.
 
 ```
 Claude Session 1 ←(stdio)→ MCP :9876 ←(WS)→
@@ -190,13 +264,13 @@ extension/
 
 mcp-server/
   index.js            # MCP server (stdio) + WebSocket client
-  tools.js            # 34 tool definitions
+  tools.js            # 40 tool definitions
   bin/cli.js          # Install CLI
 ```
 
 ### How It Works
 1. Claude Code starts → spawns MCP server via stdio
-2. MCP server binds to first available port (9876-9885)
+2. MCP server binds to first available port (9876-9895)
 3. Extension's offscreen document scans ports every 2s
 4. WebSocket connection established
 5. Commands flow: Claude Code → MCP → Extension → Chrome APIs
@@ -214,7 +288,7 @@ Browser MCP has two parts, and they update independently — how the **extension
 
 **Not sure which you have?** Open `chrome://extensions` and find Browser MCP. If it shows a **"Loaded from /path/…"** line, it's unpacked (manual updates). If there's no such line, it came from the Chrome Web Store (auto-updates).
 
-**Want zero-maintenance updates?** Install the extension from the [Chrome Web Store](https://chromewebstore.google.com/detail/agent360-browser-mcp/jdehgalffmffhfhmmhaokfbfnafnmgcl), then run `npx @agent360/browser-mcp install --skip-extension` to wire up just the MCP server. After that, both parts stay current on their own.
+**Want zero-maintenance updates?** Install the extension from the [Chrome Web Store](https://chromewebstore.google.com/detail/agent360-browser-mcp/jdehgalffmffhfhmmhaokfbfnafnmgcl), then run `claude mcp add --scope user browser-mcp -- npx @agent360/browser-mcp@latest` to register the server. After that, both parts stay current on their own — as long as your config uses `@agent360/browser-mcp@latest`.
 
 ## Troubleshooting
 
@@ -234,7 +308,7 @@ Browser MCP has two parts, and they update independently — how the **extension
 **Stale processes**
 - Processes auto-exit when Claude Code closes (stdin detection)
 - Idle timeout: 4 hours without commands → auto-exit
-- Manual cleanup: `lsof -i :9876-9885 | grep LISTEN`
+- Manual cleanup: `lsof -i :9876-9895 | grep LISTEN`
 
 ## 💡 Help Shape Browser MCP
 

package/bin/cli.js

@@ -1,14 +1,20 @@
 #!/usr/bin/env node
 
 /**
- * Browser MCP CLI — install extension + configure Claude Code
+ * Browser MCP CLI — put the extension on disk + register the MCP server
  *
  * Usage:
- *   npx @agent360/browser-mcp install   — copy extension + setup mcp.json
- *   npx @agent360/browser-mcp           — start MCP server (Claude Code calls this)
+ *   npx @agent360/browser-mcp install                     — extension files + register server
+ *   npx @agent360/browser-mcp install --skip-extension    — register the server only
+ *   npx @agent360/browser-mcp                             — start MCP server (the client calls this)
+ *
+ * Registration goes through `claude mcp add`, i.e. Claude Code's own command. An earlier
+ * version wrote ~/.claude/mcp.json directly — Claude Code does not read that path, so the
+ * install silently did nothing while printing success.
  */
 
 import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync } from 'fs';
+import { execFileSync } from 'child_process';
 import { dirname, join, resolve } from 'path';
 import { fileURLToPath } from 'url';
 import { homedir } from 'os';
@@ -16,9 +22,10 @@ import { homedir } from 'os';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkgRoot = dirname(__dirname); // mcp-server/
 const command = process.argv[2];
+const skipExtension = process.argv.includes('--skip-extension');
 
 if (command === 'install') {
-  install();
+  install({ skipExtension });
 } else if (!command) {
   // No subcommand = start MCP server (Claude Code calls this)
   // Auto-update extension files if installed via npx
@@ -29,55 +36,80 @@ if (command === 'install') {
 Browser MCP by Agent360 — control your real Chrome from Claude Code
 
 Usage:
-  npx @agent360/browser-mcp install   Install extension + configure Claude Code
-  npx @agent360/browser-mcp           Start MCP server (called by Claude Code)
+  npx @agent360/browser-mcp install                   Extension files + register the server
+  npx @agent360/browser-mcp install --skip-extension  Register the server only
+                                                      (use this if you installed the
+                                                       extension from the Chrome Web Store)
+  npx @agent360/browser-mcp                           Start MCP server (called by your client)
 
 Docs: https://github.com/Agent360dk/browser-mcp
 `);
 }
 
-function install() {
+// Register the server with Claude Code using Claude Code's own CLI. Writing a config file
+// ourselves is what broke before: ~/.claude/mcp.json is not a path Claude Code reads, so the
+// entry never took effect. `claude mcp add` writes wherever the installed version keeps it.
+function registerWithClaudeCode() {
+  try {
+    execFileSync('claude', ['mcp', 'add', '--scope', 'user', 'browser-mcp',
+                            '--', 'npx', '@agent360/browser-mcp@latest'],
+                 { stdio: 'pipe' });
+    console.log('✅ Registered with Claude Code (claude mcp add --scope user)');
+    return true;
+  } catch (err) {
+    const msg = String(err && (err.stderr || err.message) || '');
+    if (/already exists/i.test(msg)) {
+      console.log('✅ Already registered with Claude Code — nothing to do');
+      return true;
+    }
+    // `claude` not on PATH, or a different client entirely. Do not pretend it worked.
+    console.log('⚠️  Could not register automatically (the `claude` command was not found).');
+    console.log('   Register the server yourself — Claude Code:');
+    console.log('     claude mcp add --scope user browser-mcp -- npx @agent360/browser-mcp@latest');
+    console.log('   Codex:');
+    console.log('     codex mcp add browser-mcp -- npx @agent360/browser-mcp@latest');
+    console.log('   Cursor / VS Code / other — add to that client\'s MCP config:');
+    console.log('     {"mcpServers": {"browser-mcp": {"command": "npx", "args": ["@agent360/browser-mcp@latest"]}}}');
+    console.log('   Guides: https://browsermcp.dev/docs/install-claude-code/');
+    return false;
+  }
+}
+
+function install({ skipExtension = false } = {}) {
   const home = homedir();
   const extensionDir = join(home, '.browser-mcp', 'extension');
   const sourceExtension = join(pkgRoot, 'extension');
 
-  // 1. Copy extension files
   console.log('\n🔧 Browser MCP by Agent360\n');
-
-  if (!existsSync(sourceExtension)) {
-    console.error('❌ Extension files not found in package. Please report this issue.');
-    process.exit(1);
-  }
-
-  mkdirSync(extensionDir, { recursive: true });
-  cpSync(sourceExtension, extensionDir, { recursive: true });
-  console.log(`✅ Extension installed to ${extensionDir}`);
-
-  // 2. Configure Claude Code mcp.json
-  const claudeDir = join(home, '.claude');
-  const mcpJsonPath = join(claudeDir, 'mcp.json');
-  let mcpConfig = {};
-
-  if (existsSync(mcpJsonPath)) {
-    try {
-      mcpConfig = JSON.parse(readFileSync(mcpJsonPath, 'utf8'));
-    } catch {}
+  console.log('Browser MCP is two halves and needs both: a Chrome extension, and this MCP');
+  console.log('server registered with your AI client.\n');
+
+  // 1. Extension files (skipped when the user already has it from the Chrome Web Store)
+  if (skipExtension) {
+    console.log('⏭  Skipping extension files (--skip-extension)');
+  } else {
+    if (!existsSync(sourceExtension)) {
+      console.error('❌ Extension files not found in package. Please report this issue.');
+      process.exit(1);
+    }
+    mkdirSync(extensionDir, { recursive: true });
+    cpSync(sourceExtension, extensionDir, { recursive: true });
+    console.log(`✅ Extension files copied to ${extensionDir}`);
   }
 
-  if (!mcpConfig.mcpServers) mcpConfig.mcpServers = {};
-
-  mcpConfig.mcpServers['browser-mcp'] = {
-    command: 'npx',
-    args: ['@agent360/browser-mcp@latest'],
-  };
-
-  mkdirSync(claudeDir, { recursive: true });
-  writeFileSync(mcpJsonPath, JSON.stringify(mcpConfig, null, 2) + '\n');
-  console.log(`✅ Claude Code configured (${mcpJsonPath})`);
-
-  // 3. Print next steps
-  console.log(`
-📋 First-time setup (one time only):
+  // 2. Register the server
+  registerWithClaudeCode();
+
+  // 3. Print next steps — only the ones that still apply
+  if (skipExtension) {
+    console.log(`
+📋 Last step:
+  1. Make sure the Agent360 Browser MCP extension is enabled at chrome://extensions
+  2. Restart your AI client so it picks up the server
+  3. Click the extension icon — it should turn green`);
+  } else {
+    console.log(`
+📋 Load the extension in Chrome (one time only):
   1. Open Chrome
   2. Go to chrome://extensions (type it in the address bar)
   3. Enable "Developer mode" (toggle in top right corner)
@@ -85,13 +117,19 @@ function install() {
   5. Navigate to and select this folder:
      ${extensionDir}
   6. The extension "Agent360 Browser MCP" appears with a puzzle icon
-  7. Restart Claude Code — 34 browser tools are now available!
+  7. Restart your AI client — the browser tools are now available
 
+  Prefer a one-click, auto-updating extension instead of loading unpacked?
+  https://chromewebstore.google.com/detail/agent360-browser-mcp/jdehgalffmffhfhmmhaokfbfnafnmgcl
+  (then re-run this command with --skip-extension)`);
+  }
+
+  console.log(`
 🔄 Auto-updates (fully automatic):
    - MCP server: always fetches latest from npm (npx @latest)
    - Extension files: auto-copied when npm version is newer
    - Extension reload: auto-triggered via WebSocket
-   - You don't need to do anything — updates happen on every Claude Code session start
+   - You don't need to do anything — updates happen on every session start
 
 💡 Help shape Browser MCP:
    - Public wishlist:  https://github.com/Agent360dk/browser-mcp/blob/main/WISHLIST.md
@@ -102,6 +140,17 @@ function install() {
 `);
 }
 
+// Tal, ikke tekst: en ren tekstsammenligning ville sige at 1.9.0 er nyere end 1.10.0.
+function cmpSemver(a, b) {
+  const pa = String(a || '0.0.0').split('.').map(n => parseInt(n, 10) || 0);
+  const pb = String(b || '0.0.0').split('.').map(n => parseInt(n, 10) || 0);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const d = (pa[i] || 0) - (pb[i] || 0);
+    if (d) return d > 0 ? 1 : -1;
+  }
+  return 0;
+}
+
 function autoUpdateExtension() {
   const home = homedir();
   const extensionDir = join(home, '.browser-mcp', 'extension');
@@ -118,12 +167,21 @@ function autoUpdateExtension() {
     const installed = JSON.parse(readFileSync(installedManifest, 'utf8'));
     const source = JSON.parse(readFileSync(sourceManifest, 'utf8'));
 
-    if (installed.version !== source.version) {
+    // MAALT 21/8: her stod `if (installed.version !== source.version)`. Den kopierede
+    // naar versionerne var FORSKELLIGE — ikke naar pakkens var NYERE. En installation
+    // paa 1.27.1 blev derfor overskrevet af npm-pakkens 1.25.0, og linjen nedenfor
+    // meldte det som "auto-updated: 1.27.1 → 1.25.0". Det skete ved hver eneste
+    // serveropstart, saa en lokal nyere udgave kunne ikke blive liggende. Det er
+    // ogsaa forklaringen paa at ~/.browser-mcp/extension stod paa juli-kode i ugevis.
+    if (cmpSemver(source.version, installed.version) > 0) {
       cpSync(sourceExtension, extensionDir, { recursive: true });
       process.stderr.write(`[MCP] Extension auto-updated: ${installed.version} → ${source.version}\n`);
       process.stderr.write('[MCP] Extension will auto-reload when connected\n');
       // Signal to index.js that extension needs reload
       process.env.BROWSER_MCP_EXTENSION_UPDATED = '1';
+    } else if (installed.version !== source.version) {
+      // Den lokale er nyere end pakkens — typisk under udvikling. Sig det, men roer den ikke.
+      process.stderr.write(`[MCP] Extension paa disken (${installed.version}) er nyere end pakkens (${source.version}) — lader den vaere\n`);
     }
   } catch {}
 }