Widthdom/CodeIndex

cdidx

日本語版はこちら / Japanese version

CLI code indexing, MCP search, and LSP editor lookup for local repositories.

cdidx builds a local SQLite index for fast full-text, symbol, dependency, and inspection queries. Index once, then reuse it from your terminal, scripts, AI tools, or editor. Supports Windows, macOS, and Linux.

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

Index a repository and run your first query:

cdidx .
cdidx status --check --json
cdidx search "handleRequest"
cdidx definition UserService

For AI tools and editors, run cdidx mcp or cdidx lsp --db .cdidx/codeindex.db. See AI Integration for client setup and installation for other options.

What it does

• Search text and symbols, inspect definitions, and trace references and dependencies.
• Run audit recipes and inspect repository structure and potential hotspots.
• Refresh the index incrementally and expose results through CLI, JSON, MCP, or LSP.

Extraction provides retrieval hints rather than compiler-grade analysis. Conversation and code changes belong to the external tool using cdidx. See why cdidx, comparison with rg, and supported languages.

Documentation

| Topic | Reference | |---|---| | Commands and examples | User Guide | | Indexing and freshness | Index a project, check status | | Search and audits | Search code, regex find controls, multiline windows | | JSON fields and limits | Output format, Status JSON contract | | MCP, LSP, and compatibility | AI Integration, status field explanations, Integration Policy | | Installation and releases | Distribution, platforms, release verification, cloud bootstrap | | Development | Developer Guide, Testing Guide, Agent Guide | | Changes and security | Changelog, Security Policy |

Contribution Policy

Issue reports, feature requests, and improvement suggestions are welcome. External pull requests are currently not accepted; implementation and PR creation are handled by the maintainer or trusted collaborators.

License and Fair Source Use