bugkit

Users click. AI fixes. Done.

AI-friendly bug reports for any project. Users report bugs with full context — URL, element selector, stack trace, viewport, voice transcript. Admins hit one button. Paste into Claude Code or any AI coding agent. Fix ships in minutes.

stars spec v1 license MIT
promptforum.dev
bugkit full flow demo
Full flow: click → pick element → speak → paste into Claude Code → fix ships

Who this is for

🛠 Building for a client or boss

Send them the staging link. They click the bug icon, pick the broken element, speak or type what they want. You paste the output into your AI coding agent. Fix ships the same day — exactly how they described it. No more "did they mean the header or the hero?"

🚀 Running a product with users

Users click the bug icon from inside your app. Reports arrive with full context — selector, stack trace, viewport, voice transcript. Paste → AI fixes → user gets notified. Your product improves as fast as you can read reports.

Install — pick your AI agent

  1. 1
    Add the marketplace
    /plugin marketplace add bglglzd/bugkit
  2. 2
    Install the plugin
    /plugin install bugkit@bglglzd-bugkit
  3. 3
    Run the installer
    /bugkit:install

Run each command one at a time — wait for it to finish before pasting the next.

Install bugkit in this project from
https://raw.githubusercontent.com/bglglzd/bugkit/main/INSTALL.md
Install bugkit in this project from
https://raw.githubusercontent.com/bglglzd/bugkit/main/INSTALL.md
Install bugkit in this project from
https://raw.githubusercontent.com/bglglzd/bugkit/main/INSTALL.md

Paste the full contents of INSTALL.md into your AI chat. Works with Gemini CLI, Aider, Cline, and anything else that accepts a prompt.

How it works

User finds bug ↓ clicks bug icon, picks the broken element, speaks or types Report saved with full context (URL, selector, stack trace, viewport, transcript) ↓ Admin opens report → clicks "Copy Context for AI" ↓ standardized prompt with everything the AI needs Paste into Claude Code / Cursor / Copilot / ChatGPT ↓ AI fixes the bug, ships a commit ↓ Admin marks report "resolved" with a short note + commit SHA ↓ Reporter gets notified

Why this beats a feedback form

Traditional feedback formbugkit
"Something is broken"Selector, XPath, HTML, viewport, URL, stack trace, voice transcript
Admin reads, asks clarifying questionsAdmin pastes to AI, AI already has everything
Fix takes daysFix ships in minutes
Format differs per projectStandardized spec — same ritual across all your projects
No closed-loop statusReporter notified at each state change
Typing long descriptions is a chore🎤 press-to-speak, auto-transcribed

Voice — free, no keys, works on slow computers

🎤 Mic button next to the description field. Press, speak, transcript streams into the textarea live. Edit if you want, submit.

Default is the browser's Web Speech API — free, no install, no keys. Optional upgrade is local Whisper (whisper.cpp) for offline / Firefox / full privacy — ~150MB one-time model download, CPU-only. Never paid APIs as the default path.

Docs