AI-Powered Repository Analyzer

Understand any GitHub repository in seconds with intelligent AI analysis.

---

🚀 Installation

📦 Download CodeMind

✅ Available Now Get CodeMind from the Microsoft Edge Add-ons Store!

🔧 Developer Mode Install manually via instructions below

---

💡 What is CodeMind?

CodeMind is a powerful browser extension that uses AI to instantly understand any GitHub repository. Simply click a button and get:

• Smart Summaries — Understand what the project does, who it's for, and its key features
• Code Structure Analysis — Learn how the codebase is organized
• Tech Stack Detection — See all languages, frameworks, and dependencies at a glance
• Interactive Q&A — Ask follow-up questions and get detailed answers about any part of the code
• Analyzed Files View — See exactly which files were analyzed (new in v1.2.0!)

How to use:

1. Install from the Edge Add-ons Store or manually
2. Navigate to any GitHub repository
3. Click the CodeMind button next to the Insights tab
4. Configure your AI provider (Gemini, OpenAI, Claude, HuggingFace, or OpenRouter)
5. Click Analyze Repository to get your summary

---

✨ Features

Core Features

• One-Click Analysis — Click the CodeMind button on any GitHub repo
• AI Summaries — Get instant, readable explanations of complex code
• Interactive Chat — Ask follow-up questions about the repository
• Smart Caching — Results saved for 24 hours
• Analyzed Files Dropdown — See which files were included in the analysis

AI Providers

Provider	Free Tier	Description
Gemini	✅ Yes	Google's AI with generous free tier
OpenAI	❌ Paid	GPT-4o with streaming support (new!)
OpenRouter	✅ Yes	Access 100+ models (DeepSeek, Qwen, etc.)
Claude	❌ Paid	Anthropic's Claude models
HuggingFace	✅ Yes	Open-source models

v1.2.1 Highlights

• 🌐 Edge Browser Support — Fixed extension not working on Microsoft Edge
• ⏱️ Improved Timing — Increased injection timeout for slower browsers
• 🔍 URL Fallback — Added URL pattern validation for better reliability

v1.2.0 Highlights

• 🤖 OpenAI Support — GPT-4o integration with streaming
• 📂 Analyzed Files Dropdown — See which files were analyzed with glow animation
• 🌐 No GitHub Token Required — Works on public repos without authentication
• 🎯 Smart File Selection — Intelligent 80k token budget with file prioritization
• 🧠 ThinkingBox — See AI reasoning process in collapsible box
• 🎨 Redesigned UI — New Analyze button with status colors
• ⏱️ Request Throttling — Built-in cooldown to prevent rate limits

Previous Versions

v1.1.x Features

• 🧠 ThinkingBox — See AI reasoning process in collapsible box
• 🔑 GitHub Token — Handle rate limits with personal access token
• 🎨 Glass UI — Modern glassmorphism design throughout
• ⚠️ Error Handling — Clear error messages with retry options

---

🔒 Privacy Policy

Your privacy matters. CodeMind:

• ✅ Stores API keys locally in your browser only
• ✅ Never sends data to external servers (except AI providers you choose)
• ✅ Uses HTTPS for all API communications
• ✅ Allows you to clear all data anytime
• ✅ No GitHub token required for public repositories

Read the full Privacy Policy.

---

💻 Development

🛠️ Setup

# Clone the repository
git clone https://github.com/AhmedV20/codemind.git
cd codemind

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

📁 Project Structure

src/
├── background/          # Service worker & API calls
│   ├── api/             # AI provider implementations
│   └── services/        # Analysis, cache, strategies
├── content/             # UI components & hooks
│   ├── components/      # React components
│   └── utils/           # DOM scrapers, parsers
├── shared/              # Types & constants
└── popup/               # Extension popup

---

🔧 Manual Installation

Step 1: Build the extension

npm run build

Step 2: Load in Chrome/Edge

1. Open your browser and navigate to:

   • Chrome: chrome://extensions
   • Edge: edge://extensions

2. Enable Developer mode (toggle in top-right corner)

3. Click "Load unpacked"

4. Select the dist folder from the project directory

5. CodeMind is now installed! 🎉

Step 3: Configure

1. Click the CodeMind extension icon in your toolbar
2. Add your AI API key (Gemini, OpenAI, OpenRouter, Claude, or HuggingFace)
3. Navigate to any GitHub repo and start analyzing!

---

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

---

📄 License

MIT © 2026 CodeMind