# AlgorithmAce: AI-Powered LeetCode Companion 🚀

Enhance your LeetCode experience with AI assistance, friend comparisons, and daily problem notifications

⭐ Star on GitHub | 📖 Documentation | 🐛 Report Bug

Live Demo: https://algorithmace.0xarchit.is-a.dev

AlgorithmAce is a production-ready Chrome Extension (Manifest V3) that supercharges your LeetCode journey with:

• 🤖 AI-powered explanations for problem-solving logic
• 👥 Friend comparisons to track progress with peers
• 📅 Daily notifications with Problem of the Day
• 🔔 Smart reminders and motivational messages
• ⭐ GitHub star gating for premium features

Built with React, TypeScript, and Tailwind CSS, AlgorithmAce provides a sleek, modern interface. Core features (AI chat, problem search, stats) run locally in the extension; GitHub OAuth and star verification are handled securely by a minimal Cloudflare Worker backend.

• Problem of the Day (POTD): Automatically fetch and display the daily coding challenge
• User Stats Dashboard: View your solving stats, ranking, streak, and active days
• Problem Search: Search by keyword, difficulty, or topic tags
• Smart Caching: Efficient data caching using chrome.storage.local

• Multi-User Tracking: Add multiple LeetCode usernames to compare
• Visual Analytics: Beautiful radar charts showing comparative stats
• Real-time Stats: Easy/Medium/Hard problems solved, streaks, and more
• Persistent Storage: Friends list synced across devices via chrome.storage.sync

• Multi-Provider Support: Choose from Gemini and OpenAI‑compatible providers (OpenAI, Groq, etc.), or set a custom base URL
• Logic-Focused: Get explanations without code (promotes learning)
• Custom Prompts: Tailor the AI behavior to your learning style
• Chat History: Maintains conversation context per problem
• API Key Validation: Built-in verification system

• Premium Feature Lock: AI and friend comparison require GitHub star
• Automatic Verification: Hourly checks using GitHub REST API
• Smooth UX: Non-intrusive modal with easy verification flow
• Star Count Display: Shows repo popularity

• Daily POTD Alerts: Get notified at 9 AM every day
• Motivational Quotes: Random coding inspiration with each notification
• Click-to-Solve: Notifications link directly to LeetCode problems
• Smart Reminders: Periodic GitHub star reminders (max 1/day)

• Profile Configuration: Set your LeetCode username
• AI Configuration: Manage provider, API keys, models, and prompts
• Friend Management: Add/remove friends easily
• GitHub Verification: Link and verify your GitHub account

The easiest way to try AlgorithmAce without building locally is via GitHub Releases:

1. Go to the latest release: https://github.com/0xarchit/AlgorithmAce/releases
2. Download one of the assets:
   • CRX: AlgorithmAce.crx (drag-and-drop install)
   • ZIP: AlgorithmAce-dist.zip (unzip and Load unpacked)

CRX install (Chrome/Edge):

1. Open chrome://extensions/ (or edge://extensions/ on Edge)
2. Enable “Developer mode” (top-right)
3. Drag the downloaded AlgorithmAce.crx onto the page to install

Notes:

• If Chrome blocks the CRX due to security policy, use the ZIP method below.
• Manually installed CRXs don’t auto-update. Check Releases for updates.

ZIP install (Load unpacked):

1. Unzip AlgorithmAce-dist.zip
2. Open chrome://extensions/ and enable “Developer mode”
3. Click “Load unpacked” and select the unzipped dist folder

Prerequisites

• Node.js 18+ and npm/yarn/pnpm
• Google Chrome browser
• A GitHub account (for premium features)

1. Clone the repository

   git clone https://github.com/0xarchit/AlgorithmAce.git
   cd AlgorithmAce

2. Install dependencies

   npm install

3. Build the extension

   npm run build

4. Load in Chrome

   • Open Chrome and go to chrome://extensions/
   • Enable "Developer mode" (toggle in top-right)
   • Click "Load unpacked"
   • Select the dist folder from the project

5. Pin the extension

   • Click the puzzle icon in Chrome toolbar
   • Find "AlgorithmAce" and pin it

Run the extension in development mode with hot reload:

npm run dev

Then load the extension from the dist folder as described above (Load unpacked).

AlgorithmAce/
├── public/
│   ├── manifest.json          # Chrome extension manifest
│   └── icons/                 # Extension icons (16, 48, 128)
├── src/
│   ├── background/
│   │   └── background.ts      # Service worker for alarms & notifications
│   ├── services/
│   │   ├── leetcode.service.ts   # LeetCode GraphQL API
│   │   ├── github.service.ts     # GitHub REST API
│   │   └── ai.service.ts         # Multi-provider AI service
│   └── popup/
│       ├── components/
│       │   ├── Dashboard.tsx
│       │   ├── FriendComparison.tsx
│       │   ├── AIAssistant.tsx
│       │   ├── Settings.tsx
│       │   └── GitHubStarModal.tsx
│       ├── App.tsx
│       ├── main.tsx
│       └── index.css
├── popup.html
├── vite.config.ts
├── tailwind.config.js
├── tsconfig.json
└── package.json

npm run build

The production-ready extension will be in the dist folder.

1. Click the extension icon
2. Go to Settings → Profile
3. Enter your LeetCode username
4. Click "Save Profile Settings"

1. Go to Settings → AI Config
2. Select your AI provider (Gemini, OpenAI‑compatible like OpenAI or Groq, or Other for a custom base URL)
3. Enter your API key
4. Click "Check" to verify the key
5. Customize the model and prompt (optional)
6. Click "Save AI Configuration"

• Gemini: Google AI Studio
• OpenAI: OpenAI Platform
• Groq: Groq Console

1. Go to Settings → GitHub
2. Enter your GitHub username
3. Click "Star on GitHub" button
4. Star the AlgorithmAce repository
5. Return to extension and click "Verify Star"

• View today's Problem of the Day
• Check your LeetCode stats and progress
• Quick access to solve POTD

• Add friends' LeetCode usernames
• View comparative stats in a radar chart
• Track who's solving more problems

• Ask questions about problem logic
• Get reasoning without actual code
• Learn problem-solving patterns
• Maintain conversation context

• Configure all extension preferences
• Manage AI providers and keys
• Verify GitHub star status
• Add/remove friends

• ✅ Local-first: Chat history and configuration are stored locally in your browser
• ✅ AI Keys: Stored securely in chrome.storage.sync (encrypted at rest by Chrome)
• ✅ Secure GitHub OAuth: Sign-in and star verification run via our Cloudflare Worker backend (git-auth.0xarchit.is-a.dev). Your GitHub access token remains on the server; the extension only stores a short‑lived JWT. Tokens can be revoked server‑side.
• ✅ Minimal Permissions: Only the Chrome APIs necessary for core features
• ✅ No Analytics by Default: Completely opt‑in if added later
• ✅ Open Source: Full transparency of code and Worker implementation

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• LeetCode for the amazing platform
• Lucide for beautiful icons
• Tailwind CSS for utility-first CSS
• Chart.js for data visualization

• 🐛 Report Issues
• 💬 Discussions
• 📦 Releases
• ⭐ Don't forget to star the repo!