Skip to content

SimranShaikh20/BugWhisperer

Repository files navigation

πŸ› BugWhisperer

AI-Powered GitHub Issue Command Center

BugWhisperer Groq AI React Cloudflare License

Paste any GitHub repo URL β†’ Get instant AI-powered issue triage, priority kanban board, and sprint planning in seconds.

πŸš€ Live Demo Β· πŸ“– Read the Story Β· πŸ› Report Bug


🎯 What Is BugWhisperer?

BugWhisperer is an AI-powered GitHub issue analyzer that helps developers and teams instantly understand, prioritize, and plan around their open GitHub issues.

Instead of manually reading through dozens of issues trying to figure out what to fix first, BugWhisperer does it for you in seconds using Groq's blazing-fast Llama 3.1 AI.


✨ Features

πŸ” Instant AI Issue Analysis

Paste any public GitHub repo URL and get AI analysis of every open issue:

  • Root Cause β€” What is likely causing this issue
  • Suggested Fix β€” Concrete, actionable solution in plain English
  • Complexity Rating β€” Low / Medium / High
  • Priority Rating β€” Low / Medium / High / Critical

πŸ“‹ Kanban Priority Board

Issues are automatically sorted into a visual 4-column priority board:

πŸ”΄ Critical 🟠 High 🟑 Medium 🟒 Low
Fix immediately This sprint Next sprint Backlog

πŸ—“οΈ AI Sprint Planner

One click generates a complete 2-week sprint plan with:

  • Time estimates per issue (in hours)
  • Recommended team size
  • Week 1 and Week 2 breakdown
  • Backlog items for later

πŸ“€ Export to Markdown

Export the complete analysis as a .md file β€” ready to paste into your GitHub Wiki, Notion, Linear, or team docs.

πŸ’¬ Post Analysis to GitHub

Post the AI analysis directly as a formatted comment on any GitHub issue β€” closing the loop from analysis to action without leaving the app.


πŸ“Έ Screenshots

The App

Paste a GitHub repo URL β†’ Click Analyze Issues β†’ Get instant AI triage

Before vs After

Before (September 2025 β€” The Abandoned Script):

def analyze_issue(issue):
    # wanted to use openai here but ran out of time
    pass

def main():
    repo = "facebook/react"  # hardcoded lol
    get_issues(repo)
    print("done?")

After (June 2026 β€” Full AI Command Center):

  • βœ… Full React web application deployed on Cloudflare Workers
  • βœ… Analyzes any public GitHub repo instantly
  • βœ… Kanban board sorted by AI priority
  • βœ… 2-week sprint planner
  • βœ… One-click markdown export
  • βœ… Post analysis back to GitHub
  • βœ… 100% free to use

πŸ› οΈ Tech Stack

Layer Technology Why
Frontend React + TanStack + Tailwind CSS Fast, modern, type-safe
Backend Cloudflare Workers Serverless, globally distributed, free
AI Model Groq API β€” llama-3.1-8b-instant Fastest inference, free tier
GitHub Data GitHub REST API v3 Official, reliable, free
Build Tool Vite + Bun Extremely fast builds
Hosting Cloudflare Workers Free, global CDN

πŸš€ Getting Started

Prerequisites

Clone and Run Locally

# Clone the repo
git clone https://github.com/SimranShaikh20/BugWhisperer.git
cd BugWhisperer

# Install dependencies
npm install

# Copy environment file
cp .env.example .env

Add Your API Keys

Edit .env file:

GITHUB_TOKEN=ghp_your_github_token_here
GROQ_API_KEY=gsk_your_groq_api_key_here

Run Development Server

npm run dev

Open http://localhost:5173 and start analyzing!

Deploy to Cloudflare Workers

# Install Wrangler
npm install -g wrangler

# Login to Cloudflare
wrangler login

# Add secrets
wrangler secret put GITHUB_TOKEN
wrangler secret put GROQ_API_KEY

# Deploy
npm run deploy

πŸ’‘ How It Works

1. User pastes GitHub repo URL
           ↓
2. Cloudflare Worker fetches all open issues
   via GitHub REST API (authenticated)
           ↓
3. Each issue sent to Groq API (Llama 3.1)
   with structured analysis prompt
           ↓
4. AI returns for each issue:
   - root_cause
   - suggested_fix
   - complexity (Low/Medium/High)
   - priority (Low/Medium/High/Critical)
           ↓
5. React frontend renders issues in
   Kanban board sorted by priority
           ↓
6. Optional: Generate AI Sprint Plan
   Optional: Export as Markdown
   Optional: Post to GitHub as comment

πŸ“Š API Usage and Costs

Service Free Tier Limit BugWhisperer Usage
Groq API 14,400 requests/day ~5-10 per analysis
GitHub API 5,000 requests/hour ~1 per repo
Cloudflare Workers 100,000 requests/day 1 per user visit

Total cost to run: $0.00 Everything used is on a free tier.


πŸ—ΊοΈ Roadmap

  • Support for private repos (user provides their own token)
  • GitHub Actions integration β€” auto-analyze on new issues
  • Slack notifications for critical issues
  • Multi-repo comparison dashboard
  • VS Code extension
  • Team collaboration mode with shared boards

🀝 Contributing

Contributions are welcome! Here is how:

  1. Fork the repo
  2. Create your feature branch
git checkout -b feature/your-feature-name
  1. Commit your changes
git commit -m "Add: your feature description"
  1. Push to your branch
git push origin feature/your-feature-name
  1. Open a Pull Request

πŸ† Challenge Submission

This project was built for the GitHub Finish-Up-A-Thon Challenge on DEV.to.

The original broken script was started in September 2025 and abandoned after failing to get the AI integration working. Eight months later, this challenge motivated me to finally finish it β€” with the help of GitHub Copilot which helped me bridge every technical gap I had hit before.

Read the full story on DEV.to: [YOUR_DEVTO_POST_URL]


πŸ“„ License

MIT License β€” use it freely, build on it, ship it.


πŸ™ Acknowledgments


Built with ❀️ for the GitHub Finish-Up-A-Thon Challenge 2026

πŸš€ Live Demo Β· πŸ“– Read the Story Β· πŸ› Report Bug

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors