Skip to content

Vivek-736/Repo-Mind

Repository files navigation

🧠 RepoMind

Where Code Meets Clarity 💫🚀

RepoMind Logo

Transform Your Codebase into Intelligent Documentation in Seconds

RepoMind is a sophisticated AI-powered ecosystem that autonomously analyzes, documents, and monitors your repository's health.

Next.js TypeScript Drizzle Pinecone Gemini AI


🎯 The Future of Codebase Intelligence

╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║     🧠 Deep Code Analysis    •  🛡️ Robust Health Metrics    ║
║     💬 Semantic Code Chat    •  📂 Auto-Documentation       ║
║     📊 Activity Tracking     •  ⚡ Background Pipelines     ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

🌈 Why RepoMind?

"Don't just write code — understand it."

RepoMind isn't just a documentation tool. It's your repository's digital twin, powered by RAG and LLMs to provide context-aware insights that manual documentation could never match.

💎 What Makes Us Different

AI-Native

Powered by Gemini 2.0 Flash for lightning-fast architectural parsing and reasoning.

Health-First

Instant health scores based on maintainability, documentation quality, and security.

Context-Aware

RAG-powered chat using Pinecone ensures you're talking to your actual code, not generic LLMs.



🎨 Features That Fascinate

Every feature designed to make codebase management intelligent and effective


🏛️ Advanced Repository Management

Click to explore core engine features
Feature Description Impact
🤖 Codebase Parsing High-fidelity extraction of system design ⚡ 10x faster onboarding
🛡️ Health Analytics Real-time "Health Score" across dimensions 📈 Reduced tech debt
💬 Semantic Chat Natural language queries via performant RAG 💎 Instant insights
📊 Activity Stream Continuous monitoring of repository changes 🌍 Total visibility

🧠 Intelligent Analysis Arsenal

🛡️ Codebase Health Scoring

✓ Maintainability Analysis
✓ Documentation Coverage
✓ Security Vulnerability Check
✓ Structural Integrity Audit
✓ Test Coverage Metrics

A comprehensive radar chart of your repository's quality, updated with every analysis.

💬 Ask RepoMind (RAG)

✓ Natural Language Interface
✓ Pinecone Vector Search
✓ Context-Aware Reasoning
✓ Implementation Strategies
✓ Bug Hunting Assistant

Chat directly with your codebase. No more manual searching through files.

📂 Automated Documentation

✓ System Architecture Maps
✓ API Explorer (Auto-discovered)
✓ Component Library Deep-dive
✓ Dependency Relationship Mapping
✓ Markdown Export Support

Professional-grade documentation generated in seconds, not weeks.

Background Pipeline

✓ Powered by Inngest
✓ Robust Asynchronous Analysis
✓ Horizontal Scalability
✓ Retriable Job Queues
✓ Real-time Progress Tracking

Heavy-duty processing that stays out of your way while providing deep insights.


💫 Experience Excellence

🎨 Design 🚀 Performance 🔒 Security
Sleek Dark Mode UI Next.js 15 App Router Better-Auth Integration
Framer Motion Animations Drizzle ORM Type-Safety Encrypted Connection Strings
Responsive Dashboard Edge-ready Serverless Role-based Access Control
Interactive Diagrams Bun-optimized Build Secure API Gateway


🛠️ Tech Stack That Powers Innovation

Built with bleeding-edge technologies for maximum precision


⚡ Frontend Excellence

┌─────────────────────────────────┐
  🎯 Framework & Core            
├─────────────────────────────────┤
  Next.js 15         App Router 
  React 19           Server RSC 
  TypeScript 5       Type Safe  
└─────────────────────────────────┘

┌─────────────────────────────────┐
  🎨 UI & Styling                
├─────────────────────────────────┤
  Tailwind CSS 4     Modern CSS 
  Shadcn UI          Components 
  Framer Motion      Animations 
  Lucide Icons       Visuals    
└─────────────────────────────────┘

Why This Stack?

  • 🚀 Blazing fast page loads
  • 🎨 Premium dark-mode aesthetics
  • 📱 Perfectly responsive layouts

💪 Backend Power

┌─────────────────────────────────┐
  🗄️ Database & Vector           
├─────────────────────────────────┤
  PostgreSQL         Neon Cloud 
  Drizzle ORM        Type-safe  
  Pinecone           Vector DB  
└─────────────────────────────────┘

┌─────────────────────────────────┐
  🤖 AI & Orchestration          
├─────────────────────────────────┤
  Gemini 2.0 Flash   LLM Engine 
  Inngest            Workflows  
  Better-Auth        Security   
  Puter AI           Providers  
└─────────────────────────────────┘

Why This Stack?

  • 🧠 SOTA AI Reasoning
  • ⚡ Event-driven architecture
  • 🔒 Enterprise-grade security

🚀 Installation

Prerequisites

  • Node.js 20+ (Bun recommended)
  • PostgreSQL Database (Neon)
  • Pinecone API Key
  • Gemini API Key / Puter Token

Quick Start

  1. Clone the repository
git clone https://github.com/Vivek-736/RepoMind.git
cd repo-mind
  1. Install dependencies
npm install # or bun install
  1. Environment Setup
# Create .env file
cp .env.example .env

# Configure keys
DATABASE_URL=your_postgres_url
NEXT_PUBLIC_APP_URL=http://localhost:3000
PUTER_AUTH_TOKEN=your_token
GEMINI_API_KEY=your_key
PINECONE_API_KEY=your_key
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...
  1. Database Push
npx drizzle-kit push
  1. Start Servers
# App
npm run dev

# Inngest (New terminal)
npx inngest-cli@latest dev

🎯 Usage Guide

Analyzing a Repo

  1. Connect your GitHub account via the Dashboard.
  2. Select a repository or paste a public URL.
  3. Watch the Inngest pipeline trigger the AI analysis.
  4. Explore the generated architecture and documentation.

Interacting with Code

  1. Navigate to the Chat tab in any analyzed repo.
  2. Ask questions like: "How does the authentication flow work?" or "Where is the database schema defined?".
  3. Use the Health tab to identify technical debt hotspots.

🧑‍💻 Meet The Developer

💜 Built with Passion by Vivek

GitHub

Built for the future of engineering.

About

RepoMind is an AI-powered documentation generator for modern codebases that helps developers understand any GitHub repository faster. It analyzes project architecture, folder structures, dependencies, APIs, and core logic to generate clean, intelligent documentation with contextual insights. Built with Next.js, Octokit, RAG pipelines, Pinecone.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages