chromeflow 0.1.24 → 0.1.26

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

package/dist/setup.js

@@ -163,7 +163,9 @@ const CHROMEFLOW_TOOLS = [
   "get_form_fields",
   "scroll_to_element",
   "save_page_state",
-  "restore_page_state"
+  "restore_page_state",
+  // v0.1.25+
+  "take_and_copy_screenshot"
 ].map((t) => `mcp__chromeflow__${t}`);
 function patchSettingsLocalJson(cwd) {
   const claudeDir = join(cwd, ".claude");

package/dist/tools/browser.js

@@ -1,4 +1,8 @@
 import { z } from "zod";
+import { writeFileSync, copyFileSync } from "fs";
+import { tmpdir, homedir } from "os";
+import { join } from "path";
+import { execSync } from "child_process";
 function registerBrowserTools(server, bridge) {
   server.tool(
     "open_page",
@@ -46,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" });
@@ -68,6 +72,40 @@ ${lines.join("\n")}` }]
       };
     }
   );
+  server.tool(
+    "take_and_copy_screenshot",
+    `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)`)
+    },
+    async ({ save_to = "downloads" }) => {
+      const response = await bridge.request({ type: "screenshot" });
+      if (response.type !== "screenshot_response") throw new Error("Unexpected response from extension");
+      const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+      const filename = `chromeflow-${timestamp}.png`;
+      const imageBuffer = Buffer.from(response.image, "base64");
+      const tmpPath = join(tmpdir(), filename);
+      writeFileSync(tmpPath, imageBuffer);
+      const savePath = save_to === "cwd" ? join(process.cwd(), filename) : join(homedir(), "Downloads", filename);
+      copyFileSync(tmpPath, savePath);
+      let clipboardNote = "";
+      try {
+        execSync(`osascript -e 'set the clipboard to (read (POSIX file "${tmpPath}") as \xABclass PNGf\xBB)'`);
+        clipboardNote = "Copied to clipboard. ";
+      } catch {
+        clipboardNote = "";
+      }
+      return {
+        content: [
+          { type: "image", data: response.image, mimeType: "image/png" },
+          { type: "text", text: `${clipboardNote}Saved to ${savePath}` }
+        ]
+      };
+    }
+  );
   server.tool(
     "clear_overlays",
     "Remove all highlights and callout annotations from the current page. Does NOT remove the guide panel \u2014 the guide panel persists until the next flow starts.",

package/package.json

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