gasoline-agentic-browser

Branch Policy (Read First)

If you want something working, load code and run the server from STABLE. UNSTABLE makes zero promises on regressions or issues and is treated as work in progress. Stable builds are compressed, tagged, and moved to STABLE.

Agentic Browser Devtools - rapid e2e web development. Streams console logs, network errors, and exceptions to Claude Code, Copilot, Cursor, or any MCP-compatible assistant. Enterprise ready.

Documentation • Quick Start • Features • MCP Setup

curl -sSL https://raw.githubusercontent.com/brennhill/gasoline-agentic-browser-devtools-mcp/STABLE/scripts/install.sh | bash

irm https://raw.githubusercontent.com/brennhill/gasoline-agentic-browser-devtools-mcp/STABLE/scripts/install.ps1 | iex

Quick Start

Fire up Gasoline Agentic Browser Devtool MCP (Binary + Extension + Auto-Config) in one command:

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/brennhill/gasoline-agentic-browser-devtools-mcp/STABLE/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/brennhill/gasoline-agentic-browser-devtools-mcp/STABLE/scripts/install.ps1 | iex

This script automatically:

1. Downloads the latest stable binary for your platform.
2. Installs the browser extension files to ~/.gasoline/extension.
3. Auto-configures all detected MCP clients (Claude Code, Cursor, Windsurf, Zed, etc.).

Step 1: Finalize Browser Extension

1. Open chrome://extensions
2. Enable Developer mode (top right)
3. Click Load unpacked
4. Select the folder: ~/.gasoline/extension (or wherever the script printed)

Step 2: Restart Your AI Tool

Restart Claude Code, Cursor, Windsurf, or Zed. The Gasoline server will now start automatically when needed.

Full setup guide → | Per-tool install guide →

Why You Cook With Gasoline Agentic Browser Devtool MCP

No debug port required. Other tools need Chrome launched with --remote-debugging-port, which disables security sandboxing and breaks your normal browser workflow. Gasoline Agentic Browser Devtool MCP uses a standard extension — your browser stays secure and unmodified.

Single binary, zero runtime. One Go binary that runs anywhere — no runtime dependencies, no Puppeteer, no framework.

Captures what others can't. WebSocket messages, full request/response bodies, user action recording, Web Vitals, automatic regression detection, visual annotations, and Playwright test generation from real browser sessions — features no other MCP browser tool offers.

Works with every MCP tool. Claude Code, Cursor, Windsurf, Zed, Claude Desktop, VS Code + Continue. Switch AI tools without changing your debugging setup.

Enterprise-safe by design. Binds to 127.0.0.1 only. Auth headers are stripped automatically. No telemetry, no accounts, no cloud. Audit the source — it's AGPL-3.0.

What It Does

• Console logs — console.log(), .warn(), .error() with full arguments
• Network errors — Failed API calls (4xx, 5xx) with response bodies
• Exceptions — Uncaught errors with full stack traces
• WebSocket events — Connection lifecycle and message payloads
• Network bodies — Request/response payloads for API debugging
• User actions — Click, type, navigate, scroll recording with smart selectors
• Web Vitals — LCP, CLS, INP, FCP with regression detection
• DOM inspection — Query the page with CSS selectors via MCP
• Accessibility audits — WCAG checks with SARIF export
• Security audits — Credentials, PII, headers, cookies, third-party analysis
• Browser automation — Click, type, select, upload, navigate with semantic selectors
• Visual annotations — Draw mode for user feedback with computed style extraction
• Test generation — Playwright tests from context, self-healing selectors, failure classification
• Reproduction scripts — Playwright scripts from recorded user actions
• Noise filtering — Auto-detect and dismiss irrelevant errors
• Developer API — window.__gasoline.annotate() for custom context

Full feature list →

Privacy

100% local. No cloud, no analytics, no telemetry. Logs never leave your machine.

Privacy details →

Performance

See latest benchmarks for current performance data.

Last benchmarked: 2026-02-09 on darwin/arm64 (v0.8.1)

Known Issues

See docs/core/known-issues.md for current known issues.

Development

make test                              # Go server tests
node --test tests/extension/*.test.js  # Extension tests
make dev                               # Build for current platform

Release process & quality gates → · Changelog →

License

AGPL-3.0 — Free and open source for all use cases.

Artwork, logos, and the Sparky mascot are Copyright (c) Brenn Hill and are not covered by the AGPL. See LICENSE-ARTWORK for details.

cookwithgasoline.com

Pouring fuel on the AI development fire

If you find Gasoline Agentic Browser Devtool MCP useful, please consider giving it a star!