cdidx 1.20.0

cdidx

日本語版はこちら / Japanese version

AI-native local code search for terminal and MCP workflows.

cdidx indexes a repository into a local SQLite FTS5 database, then answers full-text, symbol, dependency, and inspection queries without repeatedly rescanning the same tree. It is built for humans and AI agents that need small, structured code context from local repositories.

Why cdidx

Index once. Ask many times. cdidx turns a repository into a local retrieval runtime, so humans and AI agents can pull scoped code context without rescanning or resending broad files every turn.

Details: why cdidx, cdidx vs rg, and cdidx vs VS Code workspace index.

Quick Start

curl -fsSL https://raw.githubusercontent.com/Widthdom/CodeIndex/main/install.sh | bash
cdidx .
cdidx status --check --json
cdidx search "handleRequest"
cdidx definition UserService
cdidx mcp

Use cdidx when a repository will be searched repeatedly from terminals, scripts, CI, or AI tools. Use rg when you only need a one-off text scan.

Highlights

• CLI-first search with human-readable and machine-oriented output.
• Full-text, symbol, reference, caller/callee, dependency, map, inspect, and excerpt commands.
• MCP server for AI clients such as Claude Code, Cursor, and Windsurf.
• Incremental refreshes with --files and --commits.
• Exact DB/worktree freshness checks with status --check.
• Local-first storage in .cdidx/codeindex.db.
• 78 detected languages, with symbol and graph support where available.

Documentation

• User Guide: detailed installation, command examples, options, supported languages, MCP setup, and troubleshooting.
• Cloud Bootstrap: install guidance for restricted cloud agent sessions.
• Developer Guide: architecture, implementation notes, and release workflow.
• Testing Guide: test conventions and validation commands.
• Self-Improvement Contract: rules for agents improving CodeIndex itself.
• Integration Policy: permitted CLI, JSON, MCP, and integration use.

License and Fair Source Use

CodeIndex and official cdidx binaries are source-available / Fair Source-style software under FSL-1.1-ALv2, unless a specific file or directory says otherwise. Integration materials may be Apache-2.0 where marked.

See COMMERCIAL_LICENSE.md, INTEGRATION_POLICY.md, and TRADEMARKS.md for commercial, integration, and naming details.

cdidx（日本語）

ターミナルと MCP ワークフロー向けの、AI ネイティブなローカルコード検索です。

cdidx はリポジトリをローカル SQLite FTS5 データベースにインデックスし、 同じツリーを何度も読み直さずに全文検索、シンボル、依存関係、inspect クエリへ応答します。人間と AI エージェントの両方が、ローカルリポジトリから 小さく構造化されたコード文脈を取り出すためのツールです。

なぜ cdidx なのか

一度インデックスして、何度も聞く。 cdidx はリポジトリをローカルな retrieval runtime に変え、人間と AI エージェントが毎回広いファイルを 読み直さずに、必要なコード文脈だけを取り出せるようにします。

詳細: なぜ cdidx なのか、rg との違い、 VS Code workspace index との違い。

すぐに試す

curl -fsSL https://raw.githubusercontent.com/Widthdom/CodeIndex/main/install.sh | bash
cdidx .
cdidx status --check --json
cdidx search "handleRequest"
cdidx definition UserService
cdidx mcp

ターミナル、スクリプト、CI、AI ツールから同じリポジトリを繰り返し検索する 場合は cdidx が向いています。1回限りのテキスト検索には rg が向いています。

特長

• CLI-first の検索。人間向け出力と機械処理向け出力に対応。
• 全文検索、シンボル、参照、caller/callee、依存関係、map、inspect、excerpt コマンドを提供。
• Claude Code、Cursor、Windsurf などの AI クライアント向け MCP サーバー。
• --files と --commits による差分更新。
• status --check による DB と作業ツリーの完全一致確認。
• .cdidx/codeindex.db に保存するローカルファースト設計。
• 78 言語を検出し、対応言語ではシンボルとグラフも利用可能。

ドキュメント

• ユーザーガイド: 詳細なインストール、コマンド例、オプション、 対応言語、MCP 設定、トラブルシュート。
• クラウドブートストラップ: 制限されたクラウド エージェント環境でのインストール手順。
• 開発者ガイド: アーキテクチャ、実装メモ、リリース手順。
• テストガイド: テスト規約と検証コマンド。
• 自己改善コントラクト: CodeIndex 自身を改善する エージェント向けルール。
• 統合ポリシー: CLI、JSON、MCP、各種統合で許可される利用。

ライセンスと Fair Source の扱い

CodeIndex と公式 cdidx バイナリは、ファイルやディレクトリで別途明記されない 限り FSL-1.1-ALv2 の source-available / Fair Source-style software です。統合用の素材は、明記されている場合 Apache-2.0 で利用できます。

商用利用、統合、名称の扱いについては COMMERCIAL_LICENSE.md、 INTEGRATION_POLICY.md、TRADEMARKS.md を 参照してください。