Repository navigation
1.0.0 — SQL evidence, stable MCP contracts, and project setup
Local Codebase Indexer 1.0.0 brings scoped SQL tracing, explainable dependency paths, stable MCP contracts, and simpler project setup.
Highlights
- Keep SQL objects separate across servers, databases and schemas. Qualified names, explicit
USEcontext, EF schema mappings and quoted procedure names retain their identities. Ambiguous short names return candidates. - Follow the evidence. Trace SQL access through C# methods, controller actions and Razor pages with source locations, confidence labels and visible traversal limits. Export offline HTML/SVG, Mermaid or JSON reports.
- Set up your client from the CLI.
init --client claudeandinit --client codexcreate project-local MCP configuration while preserving unrelated settings. Indexing progress is available withindex --progress. - Consume stable structured results. The seven MCP tools retain their text responses and add versioned JSON schemas, protocol negotiation, pagination, bounded summaries and retryable busy errors.
- Choose retrieval for your task. Lexical search skips vectors; a bounded vector cache helps long-running processes. Fixes cover same-line C# methods/overloads and Unicode SQL diagnostics.
- Read a shorter README. English, Traditional Chinese and Simplified Chinese documentation now focus on setup, commands and reproducible tool comparisons. Detailed evaluation records remain in the technical documentation.
Upgrade
python -m pip install --upgrade local-codebase-indexerIndex format 11 automatically rebuilds older parsed indexes on the first update. Allow time for that refresh; symbol IDs and cursors are tied to the index revision. Existing source files are unaffected.
Static analysis remains approximate. Check confidence labels and coverage warnings; unsupported dispatch and dynamic SQL can require source verification. The vector cache defaults to 128 MiB and can be disabled with INDEXER_VECTOR_CACHE_MB=0.
Validation
240 tests pass, with CI covering Linux and Windows on Python 3.10–3.13, installed packages, type/lint checks, MCP contracts and Claude client transport. Frozen retrieval benchmarks retain gains and losses; no hosted-model accuracy, token-cost or production-runtime guarantee is implied.
Changelog · CLI reference · Measured results and limitations