Know Your Bugs - AI-powered error explanation and debugging assistant
BugSight transforms cryptic error messages into clear, actionable insights. Paste any error, get instant AI-powered explanations, step-by-step solutions, and suggested fixes - all in a beautiful neon-themed interface.
- ⚡ Instant Understanding: No more googling stack traces
- 🎨 Beautiful UI: Neon-themed, smooth animations, dark/light modes
- 🔒 Privacy First: No accounts, local storage only
- 💻 VSCode Integration: Capture errors while you code
- 🤖 Smart AI: Powered by Google Gemini
# 1. Clone the repo
git clone https://github.com/yourusername/bugsight.git
cd bugsight
# 2. Setup web app
cd web
npm install
echo "GEMINI_API_KEY=your_key_here" > .env.local
npm run dev
# 3. Open http://localhost:3000Get your Gemini API key: https://makersuite.google.com/app/apikey
- Error Analysis: Paste errors, upload logs, get AI explanations
- Dashboard: Track error history, view recurring patterns, visual charts
- Extension Hub: Download VSCode extension with instructions
- Theme Toggle: Seamless dark/light mode switching
- Neon Aesthetics: Black background with cyan/purple/pink accents
- Live Detection: Auto-capture errors from terminal and diagnostics
- AI Explanations: Select error text, get instant analysis
- Local History: Track all errors in sidebar
- One-Click Copy: Copy suggested fixes instantly
- Privacy Focused: All data stored locally
Beautiful neon-themed interface for pasting and analyzing errors.
Track error history with visual charts and statistics.
Real-time error detection and AI explanations in your editor.
| Layer | Technology |
|---|---|
| Frontend | Next.js 14, React, TypeScript |
| Styling | Tailwind CSS, Framer Motion |
| Extension | VSCode Extension API |
| AI | Google Gemini API |
| Charts | Recharts |
| Icons | Lucide React |
| Deployment | Vercel (web), VSCode Marketplace (extension) |
bugsight/
├── web/ # Next.js web application
├── extension/ # VSCode extension
├── shared/ # Shared TypeScript types
└── docs/ # Documentation
See PROJECT_STRUCTURE.md for detailed breakdown.
- Neon Aesthetics: Inspired by cyberpunk and modern dev tools
- Smooth Animations: Every interaction feels fluid
- Privacy First: Your data stays on your machine
- Developer Focused: Built by developers, for developers
We welcome contributions! See CONTRIBUTING.md for guidelines.
- 🐛 Bug fixes and improvements
- ✨ New features and enhancements
- 📚 Documentation and tutorials
- 🎨 UI/UX improvements
- 🧪 Testing and quality assurance
- Quick Start Guide - Get running in 3 minutes
- Setup Guide - Detailed installation instructions
- Features - Complete feature list
- Project Structure - Codebase overview
- Contributing - How to contribute
- Browser extension (Chrome, Firefox)
- Team collaboration features
- Error knowledge base
- Multi-language UI support
- Advanced analytics dashboard
- Slack/Discord integration
- PDF/Markdown export
- Custom AI prompts
- One-click fix application
MIT License - see LICENSE for details.
- Google Gemini for AI capabilities
- Next.js team for the amazing framework
- VSCode team for extension APIs
- All contributors and users
Built with ❤️ by developers, for developers