Repository files navigation

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

Stop reading code. Start talking to it. 🚀

• Smart Context Loading: Instead of dumping entire files, RepoMind intelligently selects relevant code snippets based on your query.
• Noise Filtering: Automatically ignoresnode_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.

RepoMind usesContext Augmented Generation (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.

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

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]

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

• 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.

• 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.

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

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]

• 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.

• 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 is designed forinstant, zero-setup analysis. While other tools require installation or permissions, RepoMind works immediately in your browser.

1. The "Just Works" FactorCompetitors likeGreptile andOnboard 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 > TextGitHub Copilot andOnboard AI give you walls of text. RepoMind generatesinteractive flowcharts and diagrams, helping you visualize the code's architecture instantly.

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

4. Profile IntelligenceWe don't just analyze code; we analyzecoders. 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.

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

1. Clone the repository

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

2. Install dependencies

   npm install

3. Set up environment variables

   cp .env.example .env.local

   Edit.env.local and add your keys:

   # GitHub TokenGITHUB_TOKEN="your_github_token"# Gemini API KeyGEMINI_API_KEY="your_gemini_api_key"#Caching Vercel KVKV_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

   Visithttp://localhost:3000 in your browser

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

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

Enter: "your-org/your-repo"Open DevTools → Security ScanReview vulnerabilities by severityGet actionable fix recommendations

Open DevTools → Quality AnalysisSelect a file to analyzeView complexity metrics and issuesGet improvement suggestions

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

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

• 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

• 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

• 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

• Quick reference guide
• Keyboard shortcuts
• Feature explanations

• 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

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

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

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

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