Downloads

One-Liner Install (Recommended)

One command downloads the binary, stages the Chrome extension, and auto-configures all detected AI tools.

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

What this does:

Downloads the platform binary to ~/.gasoline/bin/
Verifies SHA-256 checksum
Extracts the Chrome extension to ~/GasolineAgenticDevtoolExtension/
Runs --install which auto-detects and configures: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Gemini CLI, OpenCode, Antigravity, Zed

Terminal availability: the built-in terminal is supported on macOS and Linux. It is currently unavailable on Windows.

After running the installer, load the extension in Chrome:

Open chrome://extensions/
Enable Developer mode (toggle in top right)
Click Load unpacked
Select ~/GasolineAgenticDevtoolExtension

Chrome Extension

The extension captures browser telemetry and sends it to the local Gasoline server.

What’s New in 0.7.x

5th Tool: analyze — Active analysis with 27 modes (DOM queries, accessibility, security audits, link health, visual annotations, API validation, forms, visual diff, and more)
Link Health & Validation — Browser-based link checker with CORS detection and SSRF-safe server-side validation
Draw Mode & Visual Annotations — Draw rectangles and type feedback directly on the page with multi-page sessions
Test Healing & Classification — Self-healing Playwright selectors and context-aware test generation
Recording & Playback — Full tab video recording with audio capture and log diff comparison
Terminal Integration (macOS + Linux) — In-browser terminal with WebSocket relay and PTY session management
Multi-Client Support — Multiple AI tools can connect to the same daemon

Alternative Install Methods

npm

npm install -g gasoline-agentic-browser && gasoline-agentic-devtools --install

From Source

git clone https://github.com/brennhill/gasoline-agentic-browser-devtools-mcp.git
cd gasoline-agentic-browser-devtools-mcp
make build
./dist/gasoline-agentic-browser-darwin-arm64  # or your platform binary

Available Binaries:

gasoline-agentic-browser-darwin-arm64 (macOS Apple Silicon)
gasoline-agentic-browser-darwin-x64 (macOS Intel)
gasoline-agentic-browser-linux-arm64 (Linux ARM64)
gasoline-agentic-browser-linux-x64 (Linux x86-64)
gasoline-agentic-browser-win32-x64.exe (Windows x86-64)

System Requirements

Browser: Chrome/Chromium 120+ (for MV3 support)
Runtime: Native Go binary (no Node.js required for standalone binary installs)
Platform: macOS, Linux, Windows
Terminal widget: macOS + Linux only (not yet available on Windows)
MCP Client: Claude Code, Cursor, Windsurf, Claude Desktop, Zed, Gemini CLI, OpenCode, Antigravity, or any other MCP-compliant system/agent

Verification

To verify the extension installed correctly:

Open any webpage
Click the Gasoline icon () in your toolbar
You should see the popup with recording and tracking options
Check the extension’s popup shows “Connected” status

To verify the binary:

~/.gasoline/bin/gasoline-agentic-devtools --doctor

Troubleshooting

Extension not appearing?

Try refreshing the page (Cmd+R / Ctrl+R)
Ensure Chrome is version 120 or higher
Check that Developer mode is enabled

Recording not working?

Click the Gasoline icon to grant recording permission
Ensure the tab you want to record is active
Check your Chrome permissions for microphone access (if recording audio)

Issues with MCP integration?

See Claude Code Integration Guide
See Cursor Integration Guide

Support

Release Notes

See GitHub Releases for complete version history.