Fire It Up

Gasoline is an open-source browser extension + MCP server that streams real-time browser telemetry (console logs, network errors, exceptions, WebSocket events) to AI coding assistants like Claude Code, Cursor, Windsurf, and Zed. One command to install. Zero dependencies.

1. Ignite the Server

# Until the Chrome extension is approved, install manually:
git clone https://github.com/brennhill/gasoline.git
cd gasoline
go run ./cmd/dev-console

You’ll see: [gasoline] v4.8.0 — HTTP on port 7890

Leave this burning. No global install needed.

Extension install:

1. Open chrome://extensions
2. Enable Developer mode
3. Click Load unpacked and select the extension/ folder in this repo

---

Once the Chrome extension is approved:

npx gasoline-mcp
# Then install from the Chrome Web Store

2. Install the Extension

Grab it from the Chrome Web Store (search “Gasoline”). Click the icon in your toolbar — it should show Connected.

Load Unpacked (Development):

1. Clone the repository
2. Open chrome://extensions → enable Developer mode
3. Click Load unpacked → select the extension/ folder

3. Connect Your AI Tool

Drop this config and your AI tool fires up Gasoline automatically:

Claude Code — .mcp.json in your project root:

{
  "mcpServers": {
    "gasoline": {
      "command": "go",
      "args": ["run", "./cmd/dev-console"]
    }
  }
}

See MCP Integration for Cursor, Windsurf, Claude Desktop, Zed, and more.

Restart your AI tool. From now on, the server ignites automatically.

How do I verify Gasoline is working?

Open your web app. Trigger an error:

console.error("Gasoline test — is the fire lit?")

Ask your AI: “What browser errors do you see?”

What tools does Gasoline give my AI?

Your AI now has 5 composite tools covering the full debugging lifecycle:

Tool	What it does
observe	Browser state — errors, logs, network, WebSocket, actions, Web Vitals, page info
analyze	Insights — performance regression, API schema, accessibility, session diffs, timeline
generate	Artifacts — Playwright tests, reproduction scripts, PR summaries, SARIF, HAR
configure	Session — persistent memory, noise filtering, log management
query_dom	Live DOM query with CSS selectors

Each tool has sub-modes. For example, observe with what: "errors" returns console errors, while what: "vitals" returns Core Web Vitals.

See MCP Integration for full tool documentation.

No MCP? No Problem.

Run standalone — Gasoline writes to ~/gasoline-logs.jsonl. Point your AI at the file.

npx gasoline-mcp

Next Steps

• MCP Integration — setup for your specific tool
• All capabilities — everything Gasoline captures