Releases: aim0xyz/bugdrop
Release list
BugDrop v0.2.3 — Desktop capture preview
BugDrop v0.2.3 adds a packaged desktop app for macOS, Windows, and Linux alongside the Chrome extension.
Highlights:
- Record a running desktop program with process-scoped logs and manually annotated steps.
- In the packaged app, optional screen video and explicit screenshots capture the selected program's visible window, even when BugDrop is in front. If that window is unavailable, BugDrop reports an error instead of recording the full display.
- Browse completed local bug reports and mark issues solved.
- Capture iOS Simulator and Android Emulator sessions from the same desktop interface.
- Try the new embedded iOS Swift Package prototype for explicit breadcrumbs and failed URLSession requests.
The Mac download is universal for Apple Silicon and Intel. Windows and Linux have separate x64 and ARM64 downloads. Downloads are generated by GitHub Actions from the v0.2.3 tag and accompanied by SHA256SUMS.txt. CI packages are not notarized or signed unless platform signing credentials are configured, so your operating system may require an additional confirmation.
Verification: 22 Node tests, 4 Swift tests, extension checks, and a signed local universal macOS DMG/ZIP build passed. GitHub Actions builds all desktop targets from the tag. The complete interactive screen-capture permission flow and native Windows/Linux capture have not been exercised end to end.
BugDrop v0.2.2 — Agent-ready timelines
BugDrop v0.2.2 makes captured browser failures easier for coding agents to follow from action to error.
Highlights:
- Interleaves clicks, failed requests, console output, and runtime errors with millisecond-relative timestamps
- Captures bounded, redacted stack traces from Error objects, uncaught errors, and unhandled promise rejections
- Prefers stable
data-testid,data-test, anddata-cyclick selectors, with structural selectors as a fallback - Uses the same compact timeline format in Markdown and Jira handoffs
- Shows stack traces clearly in the local review screen before export
- Replaces the popup's browser confirmation dialog with an explicit in-product delete confirmation
Update for unpacked installations:
- Download and extract
bugdrop-0.2.2.zip. - Replace the existing extension files, or point Chrome at the extracted folder.
- Open
chrome://extensionsand click Reload for BugDrop.
Verification:
- 18 unit tests passed, including stack capture and redaction regressions
- Full Chromium extension flow passed with the production permissions
- Both GitHub Actions runs for
mainandv0.2.2passed - Extension syntax, manifest assets, permission boundary, ZIP integrity, and desktop HTTP security checks passed
SHA-256: 33c4e0cd3b497f58c5ff2799457cde59aba7f9342192f84e91fb0371f9e302ad
BugDrop v0.2.1 — Start a new report
BugDrop v0.2.1 fixes the completed-report state in the Chrome extension popup.
Highlights:
- Adds “Delete report & start over” directly to the popup
- Confirms before deleting the previous report and its screenshots
- Returns immediately to capture setup so another bug can be recorded
- Keeps the local desktop recorder behavior unchanged; it already allows consecutive captures
- Updates the CI artifact path so future versioned packages are retained automatically
Update for unpacked installations:
- Download and extract bugdrop-0.2.1.zip.
- Replace the existing extension files, or point Chrome at the extracted folder.
- Open chrome://extensions and click Reload for BugDrop.
Verification:
- 16 unit tests passed
- Full Chromium extension flow passed, including deleting a completed report and starting a second capture
- Extension syntax, manifest assets, permission boundary, package contents, and desktop HTTP security checks passed
SHA-256: 17dd17734e879055633df0a75951cc374fff6d14baa89aa36026a8a4ecb433f0
BugDrop v0.2.0 — Smarter browser captures
BugDrop v0.2.0 makes browser captures more useful for real SPA debugging.\n\nHighlights:\n- Optional automatic screenshots after runtime errors and failed requests\n- Up to eight screenshots per capture with individual review and removal\n- Interactive privacy masks for sensitive page areas\n- Better SPA evidence with route changes, element roles, and structural selectors\n- Recording continues across same-origin reloads and navigation\n- Clearer privacy and permission boundaries throughout the UI and documentation\n\nVerification:\n- 12 unit tests passed\n- Full Chromium extension flow passed, including virtual-DOM-style rerendering, SPA routing, automatic screenshots, masking, same-origin reload continuation, and cross-origin stopping\n- Syntax, permission, packaging, and desktop HTTP security checks passed\n\nNative iOS and Android recordings still have a three-minute limit. Browser captures have no time limit and stop at 300 events.
BugDrop v0.1.0 — First preview
First public preview of BugDrop: local-first debugging evidence for web apps, iOS simulators, and Android emulators.
Included
- Chrome extension: reproduction steps, console and runtime errors, failed fetch/XHR requests, SPA navigation, and an optional screenshot.
- Local desktop controller and CLI: simulator/emulator discovery, app-scoped logs, screenshots, and optional video.
- Review captured evidence and export Markdown or JSON for a coding agent or teammate.
- No account, cloud service, or AI API key. MIT licensed.
Downloads and setup
- bugdrop-0.1.0.zip is the Chrome extension. Extract it, enable Developer mode at chrome://extensions, choose Load unpacked, and select the extracted directory. Requires Chrome 120+.
- bugdrop-0.1.0-source.zip contains the complete project, including the desktop controller and CLI. Extract it and run
npm run desktopfrom the project directory, then open http://127.0.0.1:4318. Requires Node.js 22+; no npm install is needed. iOS requires macOS/Xcode, Android requires adb and a running emulator.
Validation
For the released commit, all 11 unit tests, JavaScript/manifest checks, extension packaging, and loopback HTTP access checks passed locally. Earlier browser and simulator integration results are documented in docs/VERIFICATION.md. GitHub Actions did not start because the GitHub account is locked due to a billing issue; this release has no successful hosted CI run.
Preview limitations
This is an early prototype. There is no Chrome Web Store listing or packaged native desktop app. Physical devices are not supported. Full browser navigation ends capture. Native touch events and native network interception are not captured automatically. Secret masking is heuristic; screenshot and video pixels are not automatically redacted. Review all evidence before sharing.
One earlier Android recording startup timed out; a repeat passed, but the cause remains unconfirmed. See README.md and docs/VERIFICATION.md for full requirements, privacy boundaries, and test limitations.