💬 Commit message: Update 2026-02-11 18:40:23, 20 files, 434 lines

📁 Files changed: 20
📝 Lines changed: 434

  • .mcp.json
  • plugin.json
  • settings.json
  • CLAUDE.md
  • analyze.md
  • compare.md
  • end.md
  • extract.md
  • fill.md
  • goto.md
  • restore.md
  • save.md
  • scrape.md
  • screenshot.md
  • start.md
  • mcp.js
  • mcp.js.map
  • package-lock.json
  • package.json
  • mcp.ts

src/mcp.ts

@@ -12,7 +12,16 @@ import { type CommandLike, type ResultLike, stderrLogger as log } from './logger
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '../package.json'), 'utf-8'));
 
-const browser = new ClaudeBrowser({ headless: true, width: 1280, height: 800 });
+// Browser options configurable via launch tool
+let browserOptions = {
+  headless: true,
+  width: 1280,
+  height: 800,
+  fullscreen: false,
+  preview: false,
+  previewDelay: 2000,
+};
+let browser = new ClaudeBrowser(browserOptions);
 let launched = false;
 let currentScreenshotBuffer: Buffer | null = null;
 
@@ -54,6 +63,72 @@ const server = new McpServer({
   version: pkg.version,
 });
 
+// Launch configuration
+server.tool(
+  'launch',
+  'Launch the browser with specific options. Call before goto to configure headed/fullscreen/preview modes.',
+  {
+    headed: z
+      .boolean()
+      .optional()
+      .default(false)
+      .describe('Show browser window (default: false, headless)'),
+    fullscreen: z
+      .boolean()
+      .optional()
+      .default(false)
+      .describe('Launch in native fullscreen mode (macOS only, implies headed)'),
+    preview: z
+      .boolean()
+      .optional()
+      .default(false)
+      .describe('Highlight elements before actions with visual overlay'),
+    previewDelay: z
+      .number()
+      .optional()
+      .default(2000)
+      .describe('Preview highlight duration in ms'),
+    width: z.number().optional().default(1280).describe('Viewport width'),
+    height: z.number().optional().default(800).describe('Viewport height'),
+  },
+  withLogging('launch', async ({ headed, fullscreen, preview, previewDelay, width, height }) => {
+    // Close existing browser if launched
+    if (launched) {
+      await browser.close();
+      launched = false;
+    }
+
+    // Update options - fullscreen/preview imply headed
+    browserOptions = {
+      headless: fullscreen || preview ? false : !headed,
+      width,
+      height,
+      fullscreen,
+      preview,
+      previewDelay,
+    };
+
+    // Create new browser with updated options
+    browser = new ClaudeBrowser(browserOptions);
+    await browser.launch();
+    launched = true;
+
+    return textResult(
+      JSON.stringify({
+        ok: true,
+        message: 'Browser launched',
+        options: {
+          headed: !browserOptions.headless,
+          fullscreen,
+          preview,
+          previewDelay,
+          viewport: { width, height },
+        },
+      })
+    );
+  })
+);
+
 // Navigation
 server.tool(
   'goto',