chromeflow 0.1.54 → 0.1.56

package/CLAUDE.md

@@ -238,4 +238,30 @@ document.body.style.zoom = '1';
 1. Retry the exact same `execute_script` call
 2. If still failing, use `find_and_highlight` to show the user a download button to click manually
 
+**Shadow DOM `[role=radio]` / custom radios silently no-op**: On sites like Outlier,
+`element.click()` on a shadow-DOM radio often doesn't flip `aria-checked`. Two things
+must be true: (a) the element must be scrolled into view FIRST (`scrollIntoView({block:'center'})`),
+and (b) the full pointer-event chain must fire — not just `click()`:
+```js
+['pointerdown','mousedown','pointerup','mouseup','click'].forEach(t =>
+  el.dispatchEvent(new MouseEvent(t, {bubbles: true, cancelable: true}))
+);
+```
+After scroll, re-query the radio list — its length may change as more content becomes
+visible. Then verify `aria-checked === "true"` before moving on.
+
+**Visibility-detection overlays** (e.g. Multimango's "Content Hidden" black overlay):
+Some sites render a full-screen overlay when the tab loses focus, triggered by
+`document.visibilityState` / `document.hidden`. Chromeflow tab-switching triggers it.
+Workaround — remove the overlay and patch the APIs:
+```js
+document.querySelectorAll('[style*="z-index: 99999"]').forEach(el => el.remove());
+Object.defineProperty(document, 'hidden', { get: () => false, configurable: true });
+Object.defineProperty(document, 'visibilityState', { get: () => 'visible', configurable: true });
+['visibilitychange','blur'].forEach(t =>
+  document.addEventListener(t, e => e.stopImmediatePropagation(), true)
+);
+```
+Re-apply after every navigation.
+
 **Never use Bash to work around a stuck browser interaction.**

package/README.md

@@ -108,6 +108,26 @@ set_file_input("Upload", "/Users/you/Downloads/task.zip")
 
 Click the Chromeflow extension icon and use **"Use this window for Claude"** to lock Claude's browser operations to a specific Chrome window. This lets you freely use other Chrome windows without Claude interfering.
 
+### Running multiple Claude Code instances in parallel
+
+Chromeflow supports up to 11 Claude Code sessions running in parallel, each automating a different Chrome window without touching the others.
+
+**How it works:**
+- Each CC session spawns its own Chromeflow MCP server, which auto-discovers a free port in the range `7878-7888` (first session gets 7878, second gets 7879, etc.).
+- The Chrome extension maintains one WebSocket connection per port and tracks per-port window assignments.
+- Every browser tool call is routed to the Chrome window assigned to the port the request came in on.
+
+**Setup:**
+1. Start your first Claude Code session as normal — its Chromeflow will claim port 7878.
+2. Start a second CC session in another terminal — its Chromeflow auto-falls-back to 7879.
+3. Click the Chromeflow extension icon. The popup now shows **one row per instance** (Port 7878, Port 7879, ...) each with a green dot when live.
+4. In Chrome **window A**, open the popup and click **"Use this window"** next to Port 7878.
+5. Switch to **window B**, open the popup, and click **"Use this window"** next to Port 7879.
+
+That's it. Each CC session now drives its own Chrome window — you can run a DataAnnotation task in one window while the other session fills out a Stripe dashboard in another, with zero collision.
+
+Single-instance usage is unchanged and fully backwards compatible — the old per-window assignment is auto-migrated on first load.
+
 ## Adding to another project
 
 Run setup from the new project's directory — the MCP server is already registered globally, this just drops `CLAUDE.md` and tool permissions into the project:

package/dist/setup.js

@@ -350,8 +350,13 @@ async function runUpdate() {
     const existing = readFileSync(claudeMdPath, "utf8");
     if (existing.includes("# Chromeflow")) {
       const before = existing.slice(0, existing.indexOf("# Chromeflow")).trimEnd();
-      writeFileSync(claudeMdPath, (before ? before + "\n\n" : "") + freshContent);
-      mdResult = "updated";
+      const newContent = (before ? before + "\n\n" : "") + freshContent;
+      if (newContent === existing) {
+        mdResult = "unchanged";
+      } else {
+        writeFileSync(claudeMdPath, newContent);
+        mdResult = "updated";
+      }
     } else {
       writeFileSync(claudeMdPath, existing.trimEnd() + "\n\n" + freshContent);
       mdResult = "appended";
@@ -360,7 +365,9 @@ async function runUpdate() {
     writeFileSync(claudeMdPath, freshContent);
     mdResult = "created";
   }
-  if (mdResult === "updated") {
+  if (mdResult === "unchanged") {
+    console.log(`\u2713 ${claudeMdPath} already up to date`);
+  } else if (mdResult === "updated") {
     console.log(`\u2713 Updated chromeflow instructions in ${claudeMdPath}`);
   } else if (mdResult === "appended") {
     console.log(`\u2713 Appended chromeflow instructions to ${claudeMdPath}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromeflow",
-  "version": "0.1.54",
+  "version": "0.1.56",
   "description": "Browser guidance MCP server for Claude Code — highlights, clicks, fills, and captures from the web so you don't have to.",
   "type": "module",
   "bin": {