giancarloerra/SocratiCode

Enterprise-grade (40m+ LOC) codebase intelligence, zero-setup, local & private Plugin/Skill/Extension or MCP: hybrid semantic search, polyglot dependency graphs, symbol-level impact analysis & call-flow, interactive HTML viewer, cross-project & branch-aware search, DB/API/infra knowledge. 61% less tokens, 84% fewer calls, 37x faster. Cloud in beta.

What it solves

SocratiCode is a codebase context engine that provides AI assistants with deep semantic understanding of large-scale repositories. It solves the problem of AI agents struggling to navigate complex, multi-million line codebases where simple text search (grep) is insufficient for understanding architectural patterns, dependencies, and symbol-level impact.

How it works

The system uses a Model Context Protocol (MCP) server to integrate with AI hosts. It employs AST-aware code chunking and a hybrid search approach—combining dense vector embeddings (semantic search) and BM25 sparse vectors (keyword search) fused via Reciprocal Rank Fusion (RRF) using a Qdrant vector database. It also builds polyglot dependency graphs to enable symbol-level impact analysis and call-flow tracing across 18 languages.

Who it’s for

It is designed for developers working on enterprise-level large repositories (tested up to 40 million lines of code) who use AI coding assistants like Claude Code, Cursor, VS Code Copilot, or Gemini CLI and want a tool-independent context layer that persists across different AI tools.

Highlights

  • Hybrid Search: Combines semantic and keyword search for high-precision code retrieval.
  • Deep Intelligence: Provides symbol-level blast-radius and call-flow tracing across 18 languages.
  • Zero Configuration: Automatic Docker-based deployment of Qdrant and Ollama for local-first privacy.
  • Tool Agnostic: A single index that can be shared across multiple AI agents and IDEs.
  • Resumable Indexing: Batched indexing with checkpoints to handle crashes or interruptions on massive codebases.
  • Visual Exploration: Includes an interactive HTML graph explorer for navigating code dependencies.

Related

  • Project
    Context-Engine-AI/Context-Engine

    A semantic code search and symbol intelligence system that provides AI coding assistants with deep codebase context, memory, and navigation tools via MCP.

  • Project
    kunal12203/GrapeRoot

    A context engine for AI coding assistants that builds a semantic graph of a codebase to pre-load relevant code into prompts, reducing token costs and exploration turns.

  • Project
    CodeBendKit/codeseek

    A code intelligence CLI tool that combines AST-based call graph analysis and hybrid semantic search to help developers and AI agents navigate large codebases.

  • Project
    colbymchenry/codegraph

    A semantic code intelligence platform that builds a local knowledge graph of a codebase to provide AI agents with surgical context, reducing token costs and tool calls.

  • Project
    Houseofmvps/codesight

    A zero-dependency tool that pre-compiles codebase structure and documentation into compact context maps and wikis to drastically reduce token consumption for AI coding assistants.