LibreAI / Dev Tools / SocratiCode
// devtools · giancarloerra/SocratiCode

SocratiCode

Enterprise-grade codebase intelligence for AI agents — hybrid semantic search over 40M+ LOC, locally.

★ 3.3k stars⑂ 428 forksAGPL-3.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

SocratiCode is an open-source dev tools project by giancarloerra (giancarloerra/SocratiCode on GitHub). It has 3,336 GitHub stars and 428 forks, is released under the AGPL-3.0 license, and was last updated on GitHub on 7 October 2026.

GitHub stars
3,336
Forks
428
License
AGPL-3.0
Last updated on GitHub
7 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// features

Why people love it

Hybrid semantic search

Dense + BM25 vectors fused with Reciprocal Rank Fusion in one Qdrant round-trip — conceptual and exact-identifier search together.

AST-aware chunking

Files split at function/class boundaries via ast-grep, with incremental, batched and resumable indexing and live file watching.

Polyglot dependency graphs

Import/call graphs for 19+ languages with circular-dependency detection and Mermaid diagrams; symbol-level impact analysis.

Cross-project and branch-aware

Search linked projects in one query and keep separate indexes per git branch.

Private by default

Everything runs on your machine (Docker Qdrant + Ollama, no external calls); OpenAI/Gemini/Qdrant Cloud are optional.

Multi-agent friendly

Multiple agents share one index safely with cross-process locking and a single watcher per project.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/giancarloerra/SocratiCode.git
    cd SocratiCode
  2. Install as a host plugin/MCP server

    For VS Code-style hosts, register the server with npx; for Claude Code use the plugin — see the README Quick Start for your host.

    # VS Code / MCP hosts:
    # command: npx, args: -y --prefer-online socraticode@latest  # see README for your host's exact config
  3. Or build from source

    Clone, install and build, then register dist/index.js in your MCP host and restart it.

    git clone https://github.com/giancarloerra/SocratiCode.git
    cd SocratiCode
    npm install
    npm run build
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains SocratiCode?

It is maintained by giancarloerra on GitHub (giancarloerra/SocratiCode), where the source, issues and releases live.

Is it free to use?

Yes — it is free and open source under AGPL-3.0; note the copyleft terms apply if you distribute modified versions or run it as a network service.

Does it need a paid API key?

No — the default local setup (Ollama + Qdrant in Docker) makes no external API calls; cloud embedding providers are optional and need their own keys.

How does it compare to built-in grep/semantic search inside an IDE or agent?

Compared with built-in grep/semantic search inside an IDE or agent, SocratiCode's distinguishing focus is: enterprise-grade codebase intelligence for AI agents — hybrid semantic search over 40M+ LOC, locally. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/giancarloerra/SocratiCode (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// keep exploring

Similar tools

Dev Tools

grepai

grepai: semantic code search and call graphs for AI agents, running 100% locally on your machine.

★ 1.9k starsMIT
View guide →
Dev Tools

serena

An MCP toolkit that gives coding agents IDE-grade semantic retrieval, editing and refactoring

★ 30.1k starsGPL-3.0
View guide →
Dev Tools

semble

Fast, accurate semantic code search for agents — about 99% fewer tokens than grep plus read.

★ 6.2k starsMIT
View guide →
Dev Tools

cocoindex-code

Lightweight AST-based semantic code search CLI (ccc) that makes coding agents faster and cheaper

★ 2.8k starsApache-2.0
View guide →
Dev Tools

wigolo

Local-first web search, fetch, crawl and research for AI coding agents over MCP — no API keys.

★ 5.5k starsAGPL-3.0
View guide →
Dev Tools

fallow

Codebase intelligence for TypeScript/JavaScript — health, duplication, dead code and architecture.

★ 5.0k starsMIT
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if SocratiCode is not the right fit.

Get SocratiCode

Free and open — grab the source, star the repo, and start creating.