chromeflow 0.1.39 → 0.1.41

package/CLAUDE.md

@@ -24,7 +24,7 @@ Do NOT ask "should I open the browser?" — just do it. The user expects seamles
 
 2. **Never use `take_screenshot` to read page content.** After `scroll_page`, after
    `click_element`, after navigation — always call `get_page_text`, not `take_screenshot`.
-   `get_page_text` returns up to 20,000 characters; if truncated it tells you the next
+   `get_page_text` returns up to 10,000 characters; if truncated it tells you the next
    `startIndex` to paginate. Screenshots are only for locating an element's pixel position
    when DOM queries have already failed. Never take more than 1–2 screenshots in a row.
 

package/dist/index.js

@@ -38,6 +38,54 @@ async function main() {
   registerHighlightTools(server, bridge);
   registerCaptureTools(server, bridge);
   registerFlowTools(server, bridge);
+  server.prompt(
+    "chromeflow-status",
+    "Check if the chromeflow Chrome extension is connected and which tab is active",
+    async () => {
+      const connected = bridge.isConnected();
+      if (!connected) {
+        return {
+          messages: [{
+            role: "user",
+            content: {
+              type: "text",
+              text: "Check chromeflow status. The Chrome extension is NOT connected. Tell the user to reload the chromeflow extension in chrome://extensions."
+            }
+          }]
+        };
+      }
+      try {
+        const response = await bridge.request({ type: "list_tabs" }, 3e3);
+        const tabs = response.tabs;
+        const active = tabs.find((t) => t.active);
+        const tabList = tabs.map((t) => `${t.index}. ${t.active ? "[active] " : ""}${t.title} \u2014 ${t.url}`).join("\n");
+        return {
+          messages: [{
+            role: "user",
+            content: {
+              type: "text",
+              text: `Check chromeflow status.
+
+Extension: Connected
+Active tab: ${active?.title ?? "none"} \u2014 ${active?.url ?? ""}
+All tabs:
+${tabList}`
+            }
+          }]
+        };
+      } catch {
+        return {
+          messages: [{
+            role: "user",
+            content: {
+              type: "text",
+              text: "Check chromeflow status. Extension is connected but not responding. The user may need to reload it."
+            }
+          }]
+        };
+      }
+    }
+  );
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error("[chromeflow] MCP server running. Waiting for Claude...");

package/dist/setup.js

@@ -171,7 +171,9 @@ const CHROMEFLOW_TOOLS = [
   // v0.1.36+
   "set_file_input",
   // v0.1.39+
-  "get_console_logs"
+  "get_console_logs",
+  // v0.1.40+
+  "capture_terminal"
 ].map((t) => `mcp__chromeflow__${t}`);
 function patchSettingsLocalJson(cwd) {
   const claudeDir = join(cwd, ".claude");

package/dist/tools/browser.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { writeFileSync, copyFileSync } from "fs";
+import { writeFileSync, copyFileSync, readFileSync } from "fs";
 import { tmpdir, homedir } from "os";
 import { join } from "path";
 import { execSync } from "child_process";
@@ -106,6 +106,69 @@ save_to controls where the PNG is saved: "downloads" (default) saves to ~/Downlo
       };
     }
   );
+  server.tool(
+    "capture_terminal",
+    `Capture a screenshot of the terminal window (Terminal, iTerm2, Warp, VS Code, Ghostty, etc.) and save it as a PNG.
+Use this when you need a screenshot of terminal output \u2014 e.g. test results, build logs, or command output \u2014 to upload to a form via set_file_input.
+Auto-detects the terminal app. Returns the image to Claude AND saves the PNG file.
+The saved file path can be passed directly to set_file_input(hint, file_path) to upload it.`,
+    {
+      save_to: z.enum(["downloads", "cwd"]).optional().describe('Where to save the PNG: "downloads" (~/Downloads, default) or "cwd" (working directory)')
+    },
+    async ({ save_to = "downloads" }) => {
+      const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+      const filename = `terminal-${timestamp}.png`;
+      const savePath = save_to === "cwd" ? join(process.cwd(), filename) : join(homedir(), "Downloads", filename);
+      let captured = false;
+      try {
+        const bounds = execSync(`osascript -e '
+          tell application "System Events"
+            set termApps to {"Terminal", "iTerm2", "Warp", "kitty", "Alacritty", "Ghostty", "Code", "Cursor", "Windsurf"}
+            repeat with appName in termApps
+              if exists process (contents of appName) then
+                tell process (contents of appName)
+                  if (count of windows) > 0 then
+                    set win to window 1
+                    set pos to position of win
+                    set sz to size of win
+                    return (item 1 of pos as text) & "," & (item 2 of pos as text) & "," & (item 1 of sz as text) & "," & (item 2 of sz as text)
+                  end if
+                end tell
+              end if
+            end repeat
+            error "No terminal window found"
+          end tell
+        '`, { timeout: 5e3 }).toString().trim();
+        execSync(`screencapture -x -R${bounds} "${savePath}"`, { timeout: 5e3 });
+        captured = true;
+      } catch {
+        try {
+          execSync(`screencapture -x "${savePath}"`, { timeout: 5e3 });
+          captured = true;
+        } catch {
+        }
+      }
+      if (!captured) {
+        return {
+          content: [{ type: "text", text: "Failed to capture terminal. Ensure Screen Recording permission is granted to your terminal app in System Settings > Privacy & Security > Screen Recording." }]
+        };
+      }
+      const imageBuffer = readFileSync(savePath);
+      const base64 = imageBuffer.toString("base64");
+      let clipboardNote = "";
+      try {
+        execSync(`osascript -e 'set the clipboard to (read (POSIX file "${savePath}") as \xABclass PNGf\xBB)'`);
+        clipboardNote = "Copied to clipboard. ";
+      } catch {
+      }
+      return {
+        content: [
+          { type: "image", data: base64, 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/dist/tools/capture.js

@@ -61,7 +61,8 @@ After filling, call wait_for_click only if the user needs to review/confirm; oth
     "get_page_text",
     `Get the visible text content of the current page without taking a screenshot.
 Use this instead of take_screenshot whenever you need to read what's on the page \u2014 errors, build status, form labels, confirmation messages, etc.
-Returns up to 20,000 characters at a time. If the response ends with "... (N more characters)", call again with startIndex to read the next chunk.
+Returns up to 10,000 characters per call (~3k tokens). If the response ends with "... (N more characters)", call again with startIndex to read the next chunk.
+Use the selector parameter to scope extraction to a specific section and avoid pulling unnecessary content.
 Never use take_screenshot just to read page content \u2014 paginate with startIndex instead.`,
     {
       selector: z.string().optional().describe(

package/package.json

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