RepoMind

---

RepoMind is a free, AI-powered application using Agentic CAG to chat with any public GitHub repository or developer profile. Using an advanced Context-Aware Engine, RepoMind performs deep code analysis without requiring you to clone repositories.

Stop reading code. Start talking to it.

Features

Context-Aware Engine

• Smart Context Loading: Instead of dumping entire files, RepoMind intelligently selects relevant code snippets based on your query.
• Noise Filtering: Automatically ignores node_modules, lockfiles, and build artifacts to focus on source code.
• Multi-File Understanding: Traces dependencies and imports to understand how different parts of the codebase interact.

Agentic CAG vs RAG: The Architecture

RepoMind uses Agentic Context Augmented Generation (Agentic CAG), not traditional RAG. We don't chop your code into fragmented vectors; we load full, relevant files into the model's long context window for superior understanding.

Feature	Traditional RAG	RepoMind (Agentic CAG)
Data Unit	Small Chunks (Vectors)	Full Files
Retrieval	Similarity Search (Vector DB)	AI Agent Selection + Smart Caching
Context	Fragmented	Coherent & Complete
Memory	None (Stateless)	KV Cache (Remembers relevant files)

Caching Optimization Strategy

To ensure lightning-fast responses while staying within infrastructure limits, RepoMind employs a smart caching strategy:

graph TD
    req[Request File/Data] --> kv{Check KV Cache}
    
    kv -->|Hit| checkComp{Compressed?}
    checkComp -->|Yes| decomp[Decompress with Gunzip]
    checkComp -->|No| ret1[Return Data]
    decomp --> ret1
    
    kv -->|Miss| gh[Fetch from GitHub API]
    gh --> checkSize{Size > 2MB?}
    
    checkSize -->|Yes| skip[Skip Caching]
    checkSize -->|No| comp[Compress with Gzip]
    
    comp --> store[Store in KV with gz: prefix]
    store --> ret2[Return Data]
    skip --> ret2
    
    ret2 --> req

Workflow Architecture

graph TD
    User[User Query] -->|Input| Engine[Context-Aware Engine]
    
    subgraph " Blazing Fast Optimization"
        Engine -->|Lazy Load| Profile[Profile Metadata]
        Engine -->|Flash-Lite| Select[Smart File Selection]
        Select -->|Minimizes Tokens| Context[Relevant Context]
    end
    
    subgraph " Native Web Search"
        Engine -->|Unknown Topic?| Search[Google Search]
        Search -->|Real-time Data| Synthesis[Answer Synthesis]
    end
    
    Context --> Synthesis
    Profile --> Synthesis
    Synthesis -->|Stream| UI[Chat Interface]

Evolution & Updates

We are constantly improving RepoMind. Check out our CHANGELOG.md for the full history of updates, including our journey from v1 to the latest v1.3.2.

Visual Architecture Maps

• Auto-Generated Diagrams: Instantly turn complex code logic into clear Mermaid flowcharts and sequence diagrams.
• Interactive Zoom/Pan: Explore large diagrams with intuitive controls.
• Export Options: Save diagrams as images for documentation or presentations.

Deep Profile Intelligence (USP)

• Developer Fingerprinting: Analyze coding style, commit patterns, and language preferences of any GitHub user.
• Cross-Repo Context: Aggregate knowledge from multiple repositories to understand a developer's full skillset.
• Resume Generation: Create instant technical summaries for any developer profile.

Zero-Config Security Audits

• Vulnerability Scanning: Detect SQL injections, XSS, and auth flaws without setting up CI/CD pipelines.
• AI-Powered Triage: Get context-aware explanations of why code is vulnerable, not just static alerts.
• Fix Recommendations: Receive copy-pasteable code patches to resolve security issues.

Vulnerability Scanning Workflow

graph TD
    Start[User Requests Scan] --> Select[Select Code Files]
    Select --> Fetch[Fetch Content]
    
    subgraph "Pattern Engine (Fast)"
        Fetch --> Secrets[Detect Secrets]
        Fetch --> Patterns[Code Patterns]
        Fetch --> Deps[Check Dependencies]
    end
    
    subgraph "AI Engine (Deep)"
        Fetch -->|High Risk Files| AI[Gemini 3 Analysis]
        AI -->|Context Aware| AIFindings[AI Findings]
    end
    
    Secrets --> Dedup[Deduplicate & Aggregate]
    Patterns --> Dedup
    Deps --> Dedup
    AIFindings --> Dedup
    
    Dedup --> Report[Generate Security Report]

Mobile-First Experience

• Analyze on the Go: The only advanced code analysis tool optimized for mobile browsers.
• Touch-Friendly Interface: Swipe, tap, and zoom through codebases on your phone or tablet.
• Responsive DevTools: Access full debugging and search capabilities from anywhere.

Semantic Code Search

• Natural Language Search: "Find where user authentication happens"
• Regex & AST Search: Power-user tools for precise structural code matching.
• Instant Navigation: Jump directly to relevant lines across thousands of files.

🆚 RepoMind vs The Market

RepoMind is designed for instant, zero-setup analysis. While other tools require installation or permissions, RepoMind works immediately in your browser.

Feature	RepoMind	GitHub Copilot (Web)	Greptile	Onboard AI
Platform	Web (Any Browser)	Web (GitHub.com)	Web Dashboard	Web Dashboard
Access	Instant (Public URL)	Requires Repo Access	Requires App Install	Requires App Install
Pricing	100% Free	Enterprise / Paid	Paid (Free Tier)	Paid (Free Tier)
Visual Maps	Auto-Flowcharts	No	No	No
Profile Insights	Developer Analysis	No	No	No
Mobile UX	Mobile-First	Desktop Focused	Desktop Only	Desktop Only
Security Scan	Free AI Audit	(Advanced Security)	No	No
Tech Stack	Context-Aware	Indexed Search	Proprietary Index	Vector Search

Why RepoMind?

1. The "Just Works" Factor Competitors like Greptile and Onboard AI require you to install GitHub Apps, grant permissions, and wait for indexing. RepoMind works instantly on any public repository URL. No login or installation required to start.

2. Visuals > Text GitHub Copilot and Onboard AI give you walls of text. RepoMind generates interactive flowcharts and diagrams, helping you visualize the code's architecture instantly.

3. Mobile Freedom RepoMind is the only tool in this class built with a mobile-first philosophy. Debug code, review PRs, or learn a new library from your phone while commuting.

4. Profile Intelligence We don't just analyze code; we analyze coders. RepoMind is the only platform that aggregates data across a developer's entire portfolio to give you a "resume-style" analysis of their skills and habits.

Getting Started

Prerequisites

• Node.js 18+ and npm
• GitHub Personal Access Token (Create one here)
• Google Gemini API Key (Get one here)

Installation

1. Clone the repository

   git clone https://github.com/403errors/repomind.git
   cd repomind
   

2. Install dependencies

   npm install
   

3. Set up environment variables

   cp .env.example .env.local
   

   Edit .env.local and add your keys:

    # GitHub Token
    GITHUB_TOKEN="your_github_token"
   
    # Gemini API Key
    GEMINI_API_KEY="your_gemini_api_key"
   
    #Caching Vercel KV
    KV_REST_API_READ_ONLY_TOKEN="your_kv_rest_api_read_only_token"
    KV_REST_API_TOKEN="your_kv_rest_api_token"
    KV_REST_API_URL="your_kv_rest_api_url"
    KV_URL="your_kv_url"
    REDIS_URL="your_redis_url"
   

4. Run the development server

   npm run dev
   

5. Open the app

   Visit http://localhost:3000 in your browser

Usage Examples

Analyze a Repository

Enter: "facebook/react"
Ask: "How does the reconciliation algorithm work?"
Ask: "Find all lifecycle methods"
Ask: "Show me the file tree structure"

Explore a Developer Profile

Enter: "torvalds"
Ask: "What languages does Linus primarily use?"
Ask: "Show me his most recent projects"
Ask: "What's his coding style like?"

Security Scanning

Enter: "your-org/your-repo"
Open DevTools → Security Scan
Review vulnerabilities by severity
Get actionable fix recommendations

Code Quality Check

Open DevTools → Quality Analysis
Select a file to analyze
View complexity metrics and issues
Get improvement suggestions

Advanced Search

Open DevTools → Search
Search for "useState" (Text)
Search for "function.*async" (Regex)
Search for functions named "handle" (AST)

DevTools Features

RepoMind includes a powerful DevTools panel accessible via the wrench icon:

Search

• Text Search: Fast string matching with case sensitivity options
• Regex Search: Complex pattern matching with full regex support
• AST Search: Structural search for functions, classes, variables, imports
• Results: File paths, line numbers, code snippets with context

Quality Analysis

• Metrics: Cyclomatic complexity, LOC, function count, maintainability index
• AI Review: Gemini-powered analysis for style, bugs, best practices
• Severity Levels: Critical, high, medium, low issue classification
• Suggestions: Actionable recommendations with line numbers

Generators

• Documentation: Auto-generate comprehensive docs for any file
• Test Generation: Create unit tests based on code structure
• Refactoring: Get AI suggestions for improving code quality

Help

• Quick reference guide
• Keyboard shortcuts
• Feature explanations

Privacy & Security

• GitHub Token: Stored locally in your browser, never sent to our servers
• API Keys: Environment variables, not exposed to client
• No Data Storage: Conversations are ephemeral (optional KV cache for performance)
• Server-Side Processing: AI analysis happens on Vercel Edge, not client-side
• Open Source: Audit the code yourself

Contributing

We welcome contributions! Here's how you can help:

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

Development Guidelines

• Follow existing code style
• Write meaningful commit messages
• Update documentation for new features
• Test on multiple screen sizes

License

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

Acknowledgments

Built with amazing open-source technologies:

• Next.js - React framework
• Google Gemini - AI model
• Vercel - Hosting and KV storage
• GitHub - Repository data
• Tailwind CSS - Styling
• Framer Motion - Animations
• Mermaid - Diagrams

---