Kaboom Browser AI Devtools MCP

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.

<div align="center">

<img src="docs/assets/images/chrome_store/readme-banner-kaboom.svg" alt="KaBOOM! — Browser debugging, inspection, and verification for AI coding assistants via MCP" width="100%" />

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

</div>

---

<div align="center">

📦 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

</div>

---

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:

1. Downloads the latest stable binary for your platform.
2. Installs the browser extension files to ~/.kaboom/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: ~/.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

Full feature list →

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.

Privacy details →

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.

---

<div align="center">

<img src="docs/assets/images/sparky-wave.png" alt="Sparky the Salamander" width="120" />

gokaboom.dev

Fueling rapid development with AI

If you find Kaboom useful, please consider giving it a star.

</div>