Repolytic is an AI-powered repository intelligence tool that provides architecture visualization, semantic code navigation, and codebase analysis directly inside Visual Studio Code.
It is designed to give you instant, local-first insights into your project's structure, dependencies, and hidden architecture.
🌟 Key Features
1. Repository Architecture Visualization
Generate an interactive, high-level map of your repository.
- Visualize module relationships.
- Identify core architectural layers.
- View the architecture in a rich, drag-and-drop React Flow webview panel.
2. Deep AST Dependency Detection
Repolytic parses your codebase into Abstract Syntax Trees (AST) to uncover structural insights.
- Find Circular Dependencies: Detect complex, hidden circular references within your modules.
- Identify Core Modules: See which modules are heavily depended upon and form the backbone of your application.
3. AI-Powered Semantic Search
Search your codebase using natural language, not just regex.
- Example: "Where is the authentication flow handled?" or "How are database connections managed?"
- Powered by local sentence-transformer embeddings and persistent ChromaDB vector storage.
- Features Incremental File Watching: As you edit files, Repolytic seamlessly updates the AI index in the background without requiring a full re-index!
4. Codebase Explanations
Lost in a massive, complex file? Ask Repolytic to explain the file's purpose, its responsibilities, and how it interacts with the rest of the repository.
🚀 Getting Started
1. Installation
Install Repolytic from the VS Code Marketplace.
2. Available Commands
Open the VS Code Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and type Repolytic:
- Repolytic: Analyze Repository - Scans your workspace and indexes files.
- Repolytic: Show Architecture Graph - Opens the interactive visual webview.
- Repolytic: Semantic Search - Prompts you for a natural language query.
- Repolytic: Detect Dependencies - Outputs a summary report of dependencies and circular references.
- Repolytic: Explain Current File - Uses AI to explain the active file.
3. AI Service Configuration
Repolytic uses a dedicated Python microservice to handle heavy machine learning tasks like embedding generation and semantic retrieval.
By default, the extension will attempt to use our hosted, free-tier backend (configured to https://repolytic.onrender.com).
Running the AI Engine Locally (Recommended for Privacy): For complete privacy, you can run the AI Engine on your own machine.
- Open your VS Code Settings and search for
repolytic.aiServiceUrl. - Change the value to your local instance (e.g.,
http://127.0.0.1:8765).
🔒 Local-First AI Philosophy
We believe your code is your code. Repolytic is engineered to be local-first. It does not default to sending your entire codebase to external Cloud LLMs. It uses local AST parsers and local-first vector retrieval for maximum privacy and performance.
Enjoy navigating your codebase with Repolytic!