chromeflow 0.1.25 → 0.1.27

package/CLAUDE.md

@@ -63,7 +63,8 @@ Do NOT ask "should I open the browser?" — just do it. The user expects seamles
         [if fails] get_elements()           — get EXACT DOM coords, use these in highlight_region
         highlight_region(x,y,w,h,msg)       — use exact coords from get_elements, not estimates
         [after wait_for_click] get_page_text() — confirm result, NOT take_screenshot
-        [last resort only] take_screenshot() — only if you need to see the visual layout
+        [last resort only] take_screenshot() — returns image to Claude only (no file, no clipboard)
+        take_and_copy_screenshot()          — same as above BUT also saves PNG + copies to clipboard
    d. Pause for the user when needed:
         find_and_highlight(text, msg)        — show the user what to do
         wait_for_click()                    — wait for user interaction
@@ -108,9 +109,10 @@ Use the absolute path for `envPath` — it's the Claude Code working directory +
 - For multi-session tasks (long forms that may exceed context), call `save_page_state()` as a checkpoint. A future session can call `restore_page_state()` to reload all field values from the saved snapshot.
 
 ## Working with multiple tabs
-- `open_page(url, new_tab=true)` opens a URL without losing the current tab.
-- `list_tabs()` shows all open tabs with their index, title, and URL.
+- Before opening a new tab, call `list_tabs()` to check if the target URL is already open — use `switch_to_tab` to return to it instead of opening a duplicate.
+- `open_page(url, new_tab=true)` opens a URL without losing the current tab. Use sparingly — prefer switching to an existing tab over opening a new one.
 - `switch_to_tab("1")` switches by tab number; `switch_to_tab("form")` matches by URL or title substring.
+- `list_tabs()` shows all open tabs with their index, title, and URL.
 
 ## Error handling
 - After any action → `get_page_text()` to check for errors (not `take_screenshot`)

package/dist/tools/browser.js

@@ -50,7 +50,7 @@ ${lines.join("\n")}` }]
   );
   server.tool(
     "take_screenshot",
-    "Capture a screenshot ONLY when click_element or fill_input has failed and you need pixel coordinates to call highlight_region. DO NOT use this to check page state, confirm actions, or see what loaded \u2014 use get_page_text for all of that.",
+    "Capture a screenshot and return it to Claude only \u2014 no file is saved, nothing goes to the clipboard. Use ONLY when you need to visually inspect the page layout or get pixel coordinates for highlight_region. DO NOT use to check page state or confirm actions \u2014 use get_page_text for that. To also save or copy the image, use take_and_copy_screenshot instead.",
     {},
     async () => {
       const response = await bridge.request({ type: "screenshot" });
@@ -74,10 +74,10 @@ ${lines.join("\n")}` }]
   );
   server.tool(
     "take_and_copy_screenshot",
-    `Take a screenshot, copy it to the system clipboard, and save it as a PNG file.
-Use this when you need to share, upload, or keep a screenshot outside of Claude.
-The image is always copied to the clipboard so you can immediately paste it anywhere.
-save_to controls where the file is saved: "downloads" (default) saves to ~/Downloads, "cwd" saves to Claude's current working directory.`,
+    `Take a screenshot, return it to Claude, copy it to the system clipboard, and save it as a PNG file.
+Use this instead of take_screenshot when you need the image outside of Claude \u2014 to paste into a chat, upload to a form, or keep as a file.
+Unlike take_screenshot (Claude-only), this also puts the image on the clipboard and saves it to disk.
+save_to controls where the PNG is saved: "downloads" (default) saves to ~/Downloads, "cwd" saves to Claude's current working directory.`,
     {
       save_to: z.enum(["downloads", "cwd"]).optional().describe(`Where to save the PNG file: "downloads" (~/Downloads, default) or "cwd" (Claude's current working directory)`)
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromeflow",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "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": {