socraticode

What it does

SocratiCode is a local codebase indexing engine that builds semantic search and dependency analysis for your project. It runs entirely in Docker, requires no external API keys, and provides 25 tools for querying code: hybrid BM25 + semantic search, cross-project symbol lookup, polyglot dependency graphs, symbol-level impact analysis, and interactive HTML graph visualization. The engine uses AST-aware code chunking to handle repositories up to 40+ million lines of code. A file watcher keeps the index automatically synchronized with every code change across sessions.

Who it's for

Backend engineers and full-stack developers working with large, complex codebases who want to give Claude or other AI assistants deep semantic understanding of their codebase without sending code to external services. Teams building internal tools needing on-premise code intelligence and multi-agent support.

Common use cases

• Query a local codebase semantically to understand architectural patterns, cross-file dependencies, and code flow
• Analyze the blast radius of a change by tracing symbol-level impact across the dependency graph
• Navigate complex codebases visually using the interactive HTML graph explorer
• Provide AI assistants with searchable context artifacts including database schemas, API specs, and infrastructure configurations
• Index and search across multiple repositories simultaneously with shared multi-agent indexing

Setup pitfalls

• Requires Docker and Node.js >= 18 — ensure both are installed and running before deploying the server
• Marked risk_class: high due to filesystem read/write and network call capabilities — sandbox the server if indexing untrusted codebases
• CI pipeline is not currently passing; recent versions may contain unfixed issues requiring close monitoring