Kaboom-Browser-AI-Devtools-MCP

module

v0.8.8 Latest Latest Go to latest Published: Jul 25, 2026 License: AGPL-3.0

README ¶

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.

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.6 — 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 ~/KaboomAgenticDevtoolExtension (override with KABOOM_EXTENSION_DIR).
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: ~/KaboomAgenticDevtoolExtension (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 →

Uninstall

Clean removal of everything the installer created (binaries, extension files, autostart registration, PATH entries, MCP client configs, managed skills):

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/uninstall.sh | bash -s -- --yes

Windows (PowerShell):

irm https://raw.githubusercontent.com/brennhill/Kaboom-Browser-AI-Devtools-MCP/STABLE/scripts/uninstall.ps1 -OutFile kaboom-uninstall.ps1; ./kaboom-uninstall.ps1 -Yes

Useful flags: --dry-run (preview), --keep-data (keep logs/recordings/project state). Afterwards, remove the extension from chrome://extensions — the script can't click browser UI for you.

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.

gokaboom.dev

Fueling rapid development with AI

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

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
browser-agent command push_handlers.go — HTTP handlers for push screenshot, chat, and capabilities.	push_handlers.go — HTTP handlers for push screenshot, chat, and capabilities.
browser-agent/internal/bridge
browser-agent/internal/cli
browser-agent/internal/health
browser-agent/internal/playbooks
browser-agent/internal/terminal
browser-agent/internal/toolanalyze
browser-agent/internal/toolconfigure
browser-agent/internal/toolgenerate
browser-agent/internal/toolinteract Purpose: Handles get_readable, get_markdown, and page_summary content extraction via structured extension query types.	Purpose: Handles get_readable, get_markdown, and page_summary content extraction via structured extension query types.
browser-agent/internal/toolobserve
browser-agent/internal/toolrecording
browser-agent/internal/uploadhandler
hooks command
internal
a11ysummary
analysis Purpose: Infers JSON schema types and formats from observed API response values.	Purpose: Infers JSON schema types and formats from observed API response values.
annotation Package annotation provides in-memory storage and TTL management for draw-mode annotation sessions and their detailed DOM/style context.	Package annotation provides in-memory storage and TTL management for draw-mode annotation sessions and their detailed DOM/style context.
audit Purpose: Generates cryptographically random audit entry and session IDs.	Purpose: Generates cryptographically random audit entry and session IDs.
bridge Package bridge handles the transport layer between MCP clients and the Kaboom daemon.	Package bridge handles the transport layer between MCP clients and the Kaboom daemon.
buffers Package buffers provides a generic fixed-capacity circular buffer with cursor-based reads.	Package buffers provides a generic fixed-capacity circular buffer with cursor-based reads.
capture Layout: - accessor_counts_health.go: counters, snapshots, and health accessors - accessor_events.go: timestamp and event slice copy accessors - accessor_debug.go: debug log accessor/writer - accessor_performance.go: performance snapshot storage and retrieval	Layout: - accessor_counts_health.go: counters, snapshots, and health accessors - accessor_events.go: timestamp and event slice copy accessors - accessor_debug.go: debug log accessor/writer - accessor_performance.go: performance snapshot storage and retrieval
checkpoint Purpose: Classifies log entries by severity into fingerprinted error and warning maps for checkpoint diffs.	Purpose: Classifies log entries by severity into fingerprinted error and warning maps for checkpoint diffs.
circuit Package circuit implements a circuit breaker for the capture ingest path.	Package circuit implements a circuit breaker for the capture ingest path.
debuglog
export Package export converts captured browser telemetry into standard interchange formats.	Package export converts captured browser telemetry into standard interchange formats.
hook
hook/eval
identity
issuereport
lifecycle
mcp Package mcp defines the core MCP (Model Context Protocol) types, structured error handling, parameter validation, and response formatting used across all five tools.	Package mcp defines the core MCP (Model Context Protocol) types, structured error handling, parameter validation, and response formatting used across all five tools.
menus
noise Package noise maintains built-in and user-defined filtering rules for console, network, and websocket telemetry, including confidence-based auto-detection.	Package noise maintains built-in and user-defined filtering rules for console, network, and websocket telemetry, including confidence-based auto-detection.
pagination Package pagination provides cursor-based pagination for ring buffers.	Package pagination provides cursor-based pagination for ring buffers.
performance diff.go — Rich Action Results: performance diff computation.	diff.go — Rich Action Results: performance diff computation.
persistence Package persistence provides validated namespace/key storage, metadata handling, and background dirty-flush for session state.	Package persistence provides validated namespace/key storage, metadata handling, and background dirty-flush for session state.
pty
push push — Push delivery pipeline for browser-to-AI message injection.	push — Push delivery pipeline for browser-to-AI message injection.
queries Purpose: Runs periodic TTL-based cleanup of expired query results and pending queries.	Purpose: Runs periodic TTL-based cleanup of expired query results and pending queries.
recording Package recording implements browser session recording, storage, and replay functionality.	Package recording implements browser session recording, storage, and replay functionality.
redaction Package redaction provides configurable pattern-based scrubbing of sensitive data from MCP tool responses before they reach AI clients.	Package redaction provides configurable pattern-based scrubbing of sensitive data from MCP tool responses before they reach AI clients.
reproduction Package reproduction generates Playwright test scripts from captured enhanced-action timelines, enabling one-click reproduction of observed browser issues.	Package reproduction generates Playwright test scripts from captured enhanced-action timelines, enabling one-click reproduction of observed browser issues.
schema Purpose: Merges core and runtime properties into the complete configure tool property set.	Purpose: Merges core and runtime properties into the complete configure tool property set.
security Purpose: Implements CSP origin accumulation and policy generation from observed runtime resource usage.	Purpose: Implements CSP origin accumulation and policy generation from observed runtime resource usage.
server Package server implements core server-side log storage and provides thread-safe accessor APIs for querying captured log data.	Package server implements core server-side log storage and provides thread-safe accessor APIs for querying captured log data.
session actions-diff.go — Actions diff computation.	actions-diff.go — Actions diff computation.
state Package state resolves filesystem paths for Kaboom runtime artifacts.	Package state resolves filesystem paths for Kaboom runtime artifacts.
streaming Package streaming implements push-style alert delivery for real-time browser event notification.	Package streaming implements push-style alert delivery for real-time browser event notification.
telemetry
testgen Package testgen provides test generation from captured browser state, test failure classification, and broken selector healing.	Package testgen provides test generation from captured browser state, test failure classification, and broken selector healing.
testsync testsync.go — Shared `Eventually` helpers for tests that wait on async work.	testsync.go — Shared `Eventually` helpers for tests that wait on async work.
tools/analyze Package analyze provides the implementation for the analyze MCP tool, which performs active analysis of browser state.	Package analyze provides the implementation for the analyze MCP tool, which performs active analysis of browser state.
tools/configure Purpose: Builds per-mode parameter maps for the describe_capabilities tool response.	Purpose: Builds per-mode parameter maps for the describe_capabilities tool response.
tools/generate Package generate provides the implementation for the generate MCP tool, which produces artifacts from captured browser data.	Package generate provides the implementation for the generate MCP tool, which produces artifacts from captured browser data.
tools/interact Package interact provides the implementation for the interact MCP tool, which performs browser actions like click, type, navigate, and state management.	Package interact provides the implementation for the interact MCP tool, which performs browser actions like click, type, navigate, and state management.
tools/observe Package observe provides the implementation for the observe MCP tool, which reads captured browser state from extension buffers.	Package observe provides the implementation for the observe MCP tool, which reads captured browser state from extension buffers.
tracking
types Package types provides the foundational, zero-dependency types for Kaboom.	Package types provides the foundational, zero-dependency types for Kaboom.
upload Package upload implements the four-stage file upload pipeline with comprehensive security validation at each stage.	Package upload implements the four-stage file upload pipeline with comprehensive security validation at each stage.
util Purpose: Detects BSON binary format by validating document length and element types.	Purpose: Detects BSON binary format by validating document length and element types.