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.
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 | bashIndex a repository and run your first query:
cdidx .
cdidx status --check --json
cdidx search "handleRequest"
cdidx definition UserServiceFor 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.
- 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.
| Topic | Reference |
|---|---|
| Commands and examples | User Guide |
| Indexing and freshness | Index a project, check status |
| Search and audits | Search code, regex find controls |
| JSON fields and limits | Output format, Status JSON contract |
| MCP, LSP, and compatibility | AI Integration, Integration Policy |
| Installation and releases | Distribution, platforms, release verification, cloud bootstrap |
| Development | Developer Guide, Testing Guide, Agent Guide |
| Changes and security | Changelog, Security 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.
CodeIndex and official cdidx binaries are source-available / Fair Source-style software
under FSL-1.1-ALv2, unless stated otherwise. Marked integration materials
may use Apache-2.0.
See commercial licensing, integration policy,
and trademarks for use and naming terms.
ローカルリポジトリ向けのコード索引・検索ツール。CLI、MCP、LSPから利用できます。
cdidx はローカルの SQLite 索引を使い、全文・シンボル・依存関係の検索や
コードの調査を高速に行います。一度索引を作れば、ターミナル、スクリプト、
AIツール、エディターから繰り返し利用できます。Windows・macOS・Linuxに対応しています。
次のいずれかでインストールします。
brew install widthdom/tap/codeindex
dotnet tool install -g cdidx
curl -fsSL https://raw.githubusercontent.com/Widthdom/CodeIndex/main/install.sh | bashリポジトリを索引化して検索します。
cdidx .
cdidx status --check --json
cdidx search "handleRequest"
cdidx definition UserServiceAIツールやエディターから利用する場合は cdidx mcp または
cdidx lsp --db .cdidx/codeindex.db を起動します。設定はAIとの連携、
その他の導入方法はインストールを参照してください。
- 全文・シンボル検索、定義の確認、参照・依存関係の追跡。
- 監査レシピの実行、リポジトリ構造や変更が集中する箇所の調査。
- 索引の差分更新と、CLI・JSON・MCP・LSP経由での結果取得。
抽出結果はコード調査の手がかりであり、コンパイラー相当の解析ではありません。
対話やコード変更は cdidx を利用する外部ツールが担当します。
なぜ cdidx なのか、rgとの違い、
対応言語も参照してください。
| 目的 | 参照先 |
|---|---|
| コマンドと使用例 | ユーザーガイド |
| 索引と鮮度の管理 | プロジェクトをインデックス、状態確認 |
| 検索・監査 | コード検索、正規表現 find の制御 |
| JSONフィールドと上限 | 出力形式、Status JSON 契約 |
| MCP・LSPと互換性 | AIとの連携、統合ポリシー |
| 導入とリリース | 配布チャネル、対応環境、成果物の検証、クラウドでの導入 |
| 開発 | 開発者ガイド、テストガイド、エージェントガイド |
| 変更履歴とセキュリティ | 変更履歴、セキュリティポリシー |
Issue報告、機能要望、改善提案を歓迎します。 現在、外部からのpull requestは受け付けていません。 実装とPR作成はメンテナーまたは信頼された共同開発者が担当します。
CodeIndexと公式 cdidx バイナリは、別途明記されない限り
FSL-1.1-ALv2 に基づく source-available / Fair Source-style software です。
明記された連携用の素材には Apache-2.0 を適用できます。
利用条件と名称の扱いは商用ライセンス、
統合ポリシー、商標を参照してください。