CodeAtlas Documentation v1.0

Local-First AI Code Intelligence Engine

CodeAtlas parses source repositories into a high-performance Neo4j knowledge graph, connecting AI Agents (Cursor, Antigravity, Claude Desktop) over MCP with zero cloud dependence.

Core Philosophy

"Stop making AI read the entire codebase. Make the graph tell the AI where to look."

Rather than dumping raw files into context windows, CodeAtlas runs a Graph-RAG pipeline that resolves exact line ranges and structural evidence.

Quick Installation

# 1. Clone & Link CodeAtlas
git clone https://github.com/Hellnight2005/CodeAtlas-.git
cd CodeAtlas-
npm install
npm link

# 2. Run in any repository folder
cd /path/to/your/project
codeatlas init
codeatlas index .
codeatlas start

Key Features

⚑ Graph-RAG Pipeline
2-stage hybrid retrieval engine with 6-factor Neo4j reranking and token budgeting.
πŸ€– 8 Progressive MCP Tools
Token-efficient MCP tool suite for candidate search, symbol resolution, and execution tracing.
πŸ”’ 100% Local Privacy
All graphs, AST nodes, and logs live locally in ~/.codeatlas/. Zero telemetry.
πŸš€ Multi-Core Indexer
Parallel CPU worker pool with SHA-256 hash skipping for sub-second re-indexing.