Chrome extension for web bug reports

Bug Black Box

Record console logs, JavaScript exceptions, network requests, and user action trails into structured bug reports.

bug-report.md

# Bug Report
Mode: All tabs
Captured tabs: 3

## Steps to Reproduce
1. Clicked "Checkout"
2. Submitted "payment-form"

## JavaScript Errors
TypeError: Cannot read properties of undefined

## Network Errors
POST /api/orders status 500

## Session Replay
Captured replay events for local playback.

What It Captures

Browser evidence

Console logs, console errors, JavaScript errors, failed requests, and a screenshot from the recorded root tab.

User actions

Click and submit metadata are recorded as reproducible steps without storing typed input values.

Session replay

rrweb session data is captured locally and played back in the extension replay viewer.

Multi-tab mode

Record one tab or collect events from multiple recordable tabs in the same session.

Markdown export

Download a Markdown report with the raw report JSON included for developer handoff.

AI Explain

Optionally send selected report context to Gemini after you save your own API key and click Explain with AI.

Privacy by Explicit Recording

Bug Black Box is a developer-focused flight recorder for web applications. It monitors front-end execution parameters in real-time, helping QA engineers and software developers capture, trace, and explain bugs instantly without manually compiling reproduction steps.

Local storage: Reports, replay events, screenshots, and the optional Gemini API key are stored with chrome.storage.local.
Masked inputs: Sensitive values (e.g. passwords, bearer authorization tokens, cookies) are automatically redacted locally before any data is exported or analyzed.
No backend: Bug Black Box runs 100% locally. We do not host external tracking servers, send analytics, or transmit your session logs.

Permission Transparency

Every browser permission supports the single purpose of recording browser bug context after explicit user action.

activeTab and tabs Used exclusively to attach the recorder and sync recording timelines across the tab(s) you select. We do not track background tab activities.

storage and unlimitedStorage Used to save your local extension state, session replay data, reports, screenshots, and optional Gemini API key locally on your device.

scripting Used to inject the logging interface to read console warnings, errors, and click sequences.

webRequest Used to observe request status, failed requests, and timing metadata while recording the tabs you choose.

Host permissions Used only for pages you choose to record and for the Gemini endpoint when AI Explain is used.