chromeflow 0.1.39 → 0.1.40

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/package.json

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