cdidx
日本語版はこちら / Japanese version
CLI code indexing, MCP search, and LSP editor lookup for local repositories.
cdidx builds a local SQLite index of a repository so humans, scripts, AI agents, MCP clients, and LSP-native editors can run fast full-text, symbol, dependency, and inspection queries without repeatedly rescanning the same tree.
Why cdidx
Index once. Ask many times. cdidx turns a repository into a local retrieval runtime for repeated code investigation.
| If your workflow is... | Best fit | Why | |---|---|---| | One-off string hunting | rg | zero setup, direct file scan | | Repeated repository investigation | cdidx | local SQLite FTS5 index, structured results, incremental refresh | | VS Code-only chat context | VS Code workspace index | editor-managed context inside the Copilot / VS Code UX | | Terminal, CI, scripts, or MCP clients | cdidx | explicit CLI and MCP surfaces outside an IDE |
Details: why cdidx, cdidx vs rg, and cdidx vs VS Code workspace index.
Design boundaries
CodeIndex is a local-first code index and retrieval backend. It is not an AI editor, coding agent, chat application, compiler, or exact semantic-analysis engine. Conversation, editing, commits, pull requests, and autonomous change decisions belong to the external tool that calls cdidx.
Symbol and reference extraction are lightweight indexing hints optimized for speed, locality, explainability, and retrieval usefulness. Embeddings, vector search, and LLM-based semantic ranking are not assumptions of CodeIndex core.
NuGet.config XML receives security-policy symbols for package sources and source mappings, signature validation mode, trusted signers, certificate fingerprints, and allowUntrustedRoot, so these controls can be queried by their configured values.
Contribution Policy
Issue reports, feature requests, and improvement suggestions are welcome.
This repository currently does not accept external pull requests. Pull request creation is restricted to collaborators only, and implementation changes are handled by the maintainer or trusted collaborators.
Quick Start
Install with one of these:
brew install widthdom/tap/codeindex
dotnet tool install -g cdidx
curl -fsSL https://raw.githubusercontent.com/Widthdom/CodeIndex/main/install.sh | bash