Gasoline
Gasoline MCP is an AI Debugger, Inspector, and Observability toolkit. It acts as Chrome DevTools for AI Agents using the Model Context Protocol (MCP).
Ask AI about Gasoline
Powered by Claude Β· Grounded in docs
I know everything about Gasoline. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Branch Policy (Read First)
If you want something working, load code and run the server from
STABLE.UNSTABLEmakes zero promises on regressions or issues and is treated as work in progress. Stable builds are compressed, tagged, and moved toSTABLE.
Kaboom is an AI debugger, inspector, and verification toolkit for local-first browser development workflows. Stream console logs, network failures, exceptions, recordings, and browser evidence into any MCP-compatible coding assistant.
Documentation β’ Quick Start β’ Features β’ MCP Setup
π¦ Latest Release
Current version: v0.8.2 β Structured telemetry, session analytics, KaBOOM! branding, and contract-compliant metrics reporting.
macOS / Linux:
curl -sSL https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/install.sh | bash
Windows (PowerShell):
irm https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/install.ps1 | iex
Quick Start
Fire up Kaboom (binary + extension + auto-config) in one command:
macOS / Linux:
curl -sSL https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/install.sh | bash
Windows (PowerShell):
irm https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/install.ps1 | iex
This script automatically:
- Downloads the latest stable binary for your platform.
- Installs the browser extension files to
~/.kaboom/extension. - Auto-configures all detected MCP clients (Claude Code, Cursor, Windsurf, Zed, etc.).
Step 1: Finalize Browser Extension
- Open
chrome://extensions - Enable Developer mode (top right)
- Click Load unpacked
- Select the folder:
~/.kaboom/extension(or wherever the script printed)
Step 2: Restart Your AI Tool
Restart Claude Code, Cursor, Windsurf, or Zed. The Kaboom server will now start automatically when needed.
Full setup guide β | Per-tool install guide β
Why Teams Use Kaboom
No debug port required. Other tools need Chrome launched with --remote-debugging-port, which disables security sandboxing and breaks your normal browser workflow. Kaboom uses a standard extension, so 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 accounts, no cloud. Anonymous usage stats only (see Privacy). 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.__kaboom.annotate()for custom context
Privacy
All captured data (logs, network, actions) stays 100% local β nothing leaves your machine. No cloud, no accounts.
We collect anonymous usage statistics (tool call frequency, session duration, error rates) using a random install identifier not linked to your identity. No URLs, prompts, file contents, browsing data, or personal information is collected. Disable with KABOOM_TELEMETRY=off.
Performance
See latest benchmarks for current performance data.
Last benchmarked: 2026-02-09 on darwin/arm64
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.
Fueling rapid development with AI
If you find Kaboom useful, please consider giving it a star.
