{"id":36942210,"url":"https://github.com/403errors/repomind","last_synced_at":"2026-01-26T07:00:41.677Z","repository":{"id":326051405,"uuid":"1101564387","full_name":"403errors/repomind","owner":"403errors","description":"An open-source, AI-powered application using Agentic CAG to chat with any public GitHub repository or developer profile, offering deep code analysis, visual architecture maps and security audits","archived":false,"fork":false,"pushed_at":"2025-11-27T16:34:10.000Z","size":1055,"stargazers_count":107,"open_issues_count":0,"forks_count":10,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-28T14:49:45.860Z","etag":null,"topics":["ai","analysis","caching-strategies","cag","code-analysis","coding-assistant","deep-search","developer-tools","flowcharts","gemini","github","github-api","mobile-first","nextjs","open-source","rag","repository","security-audits","typescript","vercel"],"latest_commit_sha":null,"homepage":"https://repomind-ai.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/403errors.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-21T21:27:29.000Z","updated_at":"2025-11-28T11:29:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/403errors/repomind","commit_stats":null,"previous_names":["403errors/repomind"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/403errors/repomind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Frepomind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Frepomind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Frepomind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Frepomind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/403errors","download_url":"https://codeload.github.com/403errors/repomind/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Frepomind/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28383933,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T10:34:27.190Z","status":"ssl_error","status_checked_at":"2026-01-13T10:34:26.289Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","analysis","caching-strategies","cag","code-analysis","coding-assistant","deep-search","developer-tools","flowcharts","gemini","github","github-api","mobile-first","nextjs","open-source","rag","repository","security-audits","typescript","vercel"],"created_at":"2026-01-13T10:59:55.231Z","updated_at":"2026-01-26T07:00:41.663Z","avatar_url":"https://github.com/403errors.png","language":"TypeScript","readme":"# RepoMind\n\n![RepoMind Banner](/public/repomind.png)\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub stars](https://img.shields.io/github/stars/403errors/repomind?style=social)](https://github.com/403errors/repomind)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Next.js](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/)\n[![Gemini AI](https://img.shields.io/badge/Gemini-2.5_Flash-blue)](https://ai.google.dev/)\n[![Gemini AI](https://img.shields.io/badge/Gemini-2.5_Flash_Lite-red)](https://ai.google.dev/)\n\n**[Try RepoMind now!](https://repomind-ai.vercel.app)** \n\n**[Ask RepoMind about RepoMind :3](https://repomind-ai.vercel.app/chat?q=403errors/repomind)**\n\n\u003c/div\u003e\n\n---\n\n**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.\n\n\u003e **Stop reading code. Start talking to it.** 🚀\n\n## ✨ Features\n\n### 🧠 Context-Aware Engine\n- **Smart Context Loading**: Instead of dumping entire files, RepoMind intelligently selects relevant code snippets based on your query.\n- **Noise Filtering**: Automatically ignores `node_modules`, lockfiles, and build artifacts to focus on source code.\n- **Multi-File Understanding**: Traces dependencies and imports to understand how different parts of the codebase interact.\n\n### 🧠 CAG vs RAG: The Architecture\nRepoMind uses **Context 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.\n\n| Feature | Traditional RAG | 🧠 RepoMind (CAG) |\n| :--- | :--- | :--- |\n| **Data Unit** | Small Chunks (Vectors) | **Full Files** |\n| **Retrieval** | Similarity Search (Vector DB) | **AI Agent Selection** + **Smart Caching** |\n| **Context** | Fragmented | **Coherent \u0026 Complete** |\n| **Memory** | None (Stateless) | **KV Cache** (Remembers relevant files) |\n\n### 🔄 Workflow Architecture\n\n```mermaid\ngraph TD\n    User[User Query] --\u003e|Input| Engine[Context-Aware Engine]\n    \n    subgraph \"⚡ Blazing Fast Optimization\"\n        Engine --\u003e|Lazy Load| Profile[Profile Metadata]\n        Engine --\u003e|Flash-Lite| Select[Smart File Selection]\n        Select --\u003e|Minimizes Tokens| Context[Relevant Context]\n    end\n    \n    subgraph \"🌐 Native Web Search\"\n        Engine --\u003e|Unknown Topic?| Search[Google Search]\n        Search --\u003e|Real-time Data| Synthesis[Answer Synthesis]\n    end\n    \n    Context --\u003e Synthesis\n    Profile --\u003e Synthesis\n    Synthesis --\u003e|Stream| UI[Chat Interface]\n```\n\n### 📈 Evolution \u0026 Updates\nWe are constantly improving RepoMind. Check out our **[CHANGELOG.md](CHANGELOG.md)** for the full history of updates, including our journey from v1 to the latest **v1.3.2**.\n\n### 📊 Visual Architecture Maps\n- **Auto-Generated Diagrams**: Instantly turn complex code logic into clear Mermaid flowcharts and sequence diagrams.\n- **Interactive Zoom/Pan**: Explore large diagrams with intuitive controls.\n- **Export Options**: Save diagrams as images for documentation or presentations.\n\n### 👤 Deep Profile Intelligence (USP)\n- **Developer Fingerprinting**: Analyze coding style, commit patterns, and language preferences of any GitHub user.\n- **Cross-Repo Context**: Aggregate knowledge from multiple repositories to understand a developer's full skillset.\n- **Resume Generation**: Create instant technical summaries for any developer profile.\n\n### 🛡️ Zero-Config Security Audits\n- **Vulnerability Scanning**: Detect SQL injections, XSS, and auth flaws without setting up CI/CD pipelines.\n- **AI-Powered Triage**: Get context-aware explanations of *why* code is vulnerable, not just static alerts.\n- **Fix Recommendations**: Receive copy-pasteable code patches to resolve security issues.\n\n### 📱 Mobile-First Experience\n- **Analyze on the Go**: The only advanced code analysis tool optimized for mobile browsers.\n- **Touch-Friendly Interface**: Swipe, tap, and zoom through codebases on your phone or tablet.\n- **Responsive DevTools**: Access full debugging and search capabilities from anywhere.\n\n### 🔍 Semantic Code Search\n- **Natural Language Search**: \"Find where user authentication happens\"\n- **Regex \u0026 AST Search**: Power-user tools for precise structural code matching.\n- **Instant Navigation**: Jump directly to relevant lines across thousands of files.\n\n## 🆚 RepoMind vs The Market\n\nRepoMind is designed for **instant, zero-setup analysis**. While other tools require installation or permissions, RepoMind works immediately in your browser.\n\n| Feature | 🧠 RepoMind | 🐙 GitHub Copilot (Web) | 🦎 Greptile | 🚢 Onboard AI |\n| :--- | :---: | :---: | :---: | :---: |\n| **Platform** | **🌐 Web (Any Browser)** | 🌐 Web (GitHub.com) | 🌐 Web Dashboard | 🌐 Web Dashboard |\n| **Access** | **⚡ Instant (Public URL)** | Requires Repo Access | Requires App Install | Requires App Install |\n| **Pricing** | **💸 100% Free** | Enterprise / Paid | Paid (Free Tier) | Paid (Free Tier) |\n| **Visual Maps** | **✅ Auto-Flowcharts** | ❌ No | ❌ No | ❌ No |\n| **Profile Insights** | **✅ Developer Analysis** | ❌ No | ❌ No | ❌ No |\n| **Mobile UX** | **✅ Mobile-First** | ⚠️ Desktop Focused | ❌ Desktop Only | ❌ Desktop Only |\n| **Security Scan** | **✅ Free AI Audit** | ✅ (Advanced Security) | ❌ No | ❌ No |\n| **Tech Stack** | **Context-Aware** | Indexed Search | Proprietary Index | Vector Search |\n\n### 🎯 Why RepoMind?\n\n**1. The \"Just Works\" Factor**\nCompetitors 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.\n\n**2. Visuals \u003e Text**\n**GitHub Copilot** and **Onboard AI** give you walls of text. RepoMind generates **interactive flowcharts** and diagrams, helping you visualize the code's architecture instantly.\n\n**3. Mobile Freedom**\nRepoMind 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.\n\n**4. Profile Intelligence**\nWe 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.\n\n## 🚀 Getting Started\n\n### Prerequisites\n- **Node.js** 18+ and npm\n- **GitHub Personal Access Token** ([Create one here](https://github.com/settings/tokens))\n- **Google Gemini API Key** ([Get one here](https://ai.google.dev/))\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/403errors/repomind.git\n   cd repomind\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Set up environment variables**\n   ```bash\n   cp .env.example .env.local\n   ```\n   \n   Edit `.env.local` and add your keys:\n   ```env\n    # GitHub Token\n    GITHUB_TOKEN=\"your_github_token\"\n\n    # Gemini API Key\n    GEMINI_API_KEY=\"your_gemini_api_key\"\n\n    #Caching Vercel KV\n    KV_REST_API_READ_ONLY_TOKEN=\"your_kv_rest_api_read_only_token\"\n    KV_REST_API_TOKEN=\"your_kv_rest_api_token\"\n    KV_REST_API_URL=\"your_kv_rest_api_url\"\n    KV_URL=\"your_kv_url\"\n    REDIS_URL=\"your_redis_url\"\n   ```\n\n4. **Run the development server**\n   ```bash\n   npm run dev\n   ```\n\n5. **Open the app**\n   \n   Visit [http://localhost:3000](http://localhost:3000) in your browser\n\n## 📖 Usage Examples\n\n### Analyze a Repository\n```\nEnter: \"facebook/react\"\nAsk: \"How does the reconciliation algorithm work?\"\nAsk: \"Find all lifecycle methods\"\nAsk: \"Show me the file tree structure\"\n```\n\n### Explore a Developer Profile\n```\nEnter: \"torvalds\"\nAsk: \"What languages does Linus primarily use?\"\nAsk: \"Show me his most recent projects\"\nAsk: \"What's his coding style like?\"\n```\n\n### Security Scanning\n```\nEnter: \"your-org/your-repo\"\nOpen DevTools → Security Scan\nReview vulnerabilities by severity\nGet actionable fix recommendations\n```\n\n### Code Quality Check\n```\nOpen DevTools → Quality Analysis\nSelect a file to analyze\nView complexity metrics and issues\nGet improvement suggestions\n```\n\n### Advanced Search\n```\nOpen DevTools → Search\nSearch for \"useState\" (Text)\nSearch for \"function.*async\" (Regex)\nSearch for functions named \"handle\" (AST)\n```\n\n## 🛠️ DevTools Features\n\nRepoMind includes a powerful DevTools panel accessible via the wrench icon:\n\n### 🔍 Search\n- **Text Search**: Fast string matching with case sensitivity options\n- **Regex Search**: Complex pattern matching with full regex support\n- **AST Search**: Structural search for functions, classes, variables, imports\n- **Results**: File paths, line numbers, code snippets with context\n\n### ✅ Quality Analysis\n- **Metrics**: Cyclomatic complexity, LOC, function count, maintainability index\n- **AI Review**: Gemini-powered analysis for style, bugs, best practices\n- **Severity Levels**: Critical, high, medium, low issue classification\n- **Suggestions**: Actionable recommendations with line numbers\n\n### ⚡ Generators\n- **Documentation**: Auto-generate comprehensive docs for any file\n- **Test Generation**: Create unit tests based on code structure\n- **Refactoring**: Get AI suggestions for improving code quality\n\n### 💬 Help\n- Quick reference guide\n- Keyboard shortcuts\n- Feature explanations\n\n## 🔒 Privacy \u0026 Security\n\n- **GitHub Token**: Stored locally in your browser, never sent to our servers\n- **API Keys**: Environment variables, not exposed to client\n- **No Data Storage**: Conversations are ephemeral (optional KV cache for performance)\n- **Server-Side Processing**: AI analysis happens on Vercel Edge, not client-side\n- **Open Source**: Audit the code yourself\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how you can help:\n\n1. **Fork the repository**\n2. **Create a feature branch**: `git checkout -b feature/amazing-feature`\n3. **Commit your changes**: `git commit -m 'Add amazing feature'`\n4. **Push to the branch**: `git push origin feature/amazing-feature`\n5. **Open a Pull Request**\n\n### Development Guidelines\n- Follow existing code style\n- Write meaningful commit messages\n- Update documentation for new features\n- Test on multiple screen sizes\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\nBuilt with amazing open-source technologies:\n- [Next.js](https://nextjs.org/) - React framework\n- [Google Gemini](https://ai.google.dev/) - AI model\n- [Vercel](https://vercel.com/) - Hosting and KV storage\n- [GitHub](https://github.com/) - Repository data\n- [Tailwind CSS](https://tailwindcss.com/) - Styling\n- [Framer Motion](https://www.framer.com/motion/) - Animations\n- [Mermaid](https://mermaid.js.org/) - Diagrams\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by [403errors](https://github.com/403errors)**\n\n[⭐ Star on GitHub](https://github.com/403errors/repomind) • [🐛 Report Bug](https://github.com/403errors/repomind/issues) • [✨ Request Feature](https://github.com/403errors/repomind/issues)\n\n\u003c/div\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F403errors%2Frepomind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F403errors%2Frepomind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F403errors%2Frepomind/lists"}