socraticode — Claude Code plugin: semantic codebase search
A local context engine that indexes your repo and hands the agent semantic search, dependency graphs and symbol-level impact analysis.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install socraticode@claude-communityWhat socraticode does
SocratiCode builds a local index of your codebase and serves it to the agent over MCP. Search is hybrid: semantic embeddings plus BM25, fused with RRF. Under the hood it chunks files with AST awareness, builds polyglot dependency graphs with circular-dependency detection, and traces call flow and blast radius at symbol level. Database schemas, API specs and infra configs get indexed too, so they show up in the same search.
Indexing runs in batches with resumable checkpoints, so a pause, crash or restart doesn't lose progress. A file watcher keeps the index current on every change, and several agents can share one index at once.
Everything runs locally. Docker handles the setup, no API keys needed. Cloud embeddings (OpenAI, Google Gemini) and Qdrant are optional if you want them. No running Docker, no plugin — check that first. The license is AGPL-3.0, which matters if you plan to embed the engine in your own product.
What it helps with
- find the right code in a repo with tens of millions of lines
- trace what breaks when you change a function
- spot circular dependencies between modules
- keep the index fresh after every file edit
- search database schemas and API specs alongside code
Example prompts for the agent
- Index this repository and find where authorization is handled
- Show me the dependency graph for the
billingmodule and any cycles in it - What breaks if I change this function's signature?
How to install socraticode
Plugin marketplace
/plugin marketplace add anthropics/claude-plugins-community/plugin install socraticode@claude-communityStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about socraticode
How do I install socraticode in Claude Code?
Add the marketplace with /plugin marketplace add anthropics/claude-plugins-community, then install the plugin: /plugin install socraticode@claude-community.
What does socraticode do?
It indexes your codebase and gives the agent semantic search, dependency graphs, symbol-level impact analysis and search over infrastructure artifacts.
Does socraticode need API keys?
No. Everything runs locally through Docker by default. OpenAI or Google Gemini embeddings and Qdrant are only for the cloud setup.
