High-performance codebase analysis engine and interactive mapping tool.
Understand complex architectures, visualize dependencies, and navigate large-scale projects with clarity.

Overview · Features · Architecture · Getting Started · Development · Testing

Cortex pairs a fast analysis engine with a polished desktop experience so teams can explore codebases like a map. It helps you uncover structure, surface dependencies, and navigate large projects faster—ideal for onboarding, architecture reviews, and refactors.

• Interactive codebase mapping to visualize modules and relationships.
• High-performance analysis engine built on FastAPI and extensible plugins.
• Desktop-first workflow with Electron + React for a fluid experience.
• Modular architecture supporting multiple analysis strategies.
• Modern UI stack powered by TypeScript, Vite, and Tailwind CSS.

• Node.js >= 20
• pnpm >= 9
• Python >= 3.10

git clone https://github.com/M-R21/Code-Mind-Mapper.git
# Or your fork:
# git clone https://github.com/your-username/Code-Mind-Mapper.git
cd Code-Mind-Mapper
pnpm install

cd engine
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt

Start the engine and desktop app in separate terminals:

# Terminal 1
cd engine
python main.py

# Terminal 2 (repo root)
pnpm dev

pnpm test:engine
pnpm test:ui

We welcome contributions! Please review CONTRIBUTING.md and CODE_OF_CONDUCT.md before submitting changes.

For security disclosures, see SECURITY.md.

Licensed under the MIT License.

Built with ❤️ by M-R21.