defendend/Claude-ast-index-search

何を解決するか

大規模なマルチ言語コードベースをナビゲートする際、単純なテキスト検索（例：grep）では速度が遅すぎたり、正確性が低すぎることがあります。このツールは、開発者やAIエージェントが、ファイル全体を読んだり、シンボルの定義場所を推測したりせずに、クラス、関数、依存関係などの正確な構造要素を検出できるようにします。

動作方法

このツールはプロジェクトの抽象構文木（AST）のローカルSQLiteインデックスを構築します。コードの構造を解析することで、シンボル、参照、インポート、モジュール、継承パターンをマッピングします。ユーザーはCLIからこのインデックスを照会し、定義に直接ジャンプしたり、シンボルのすべての使用箇所を検索したり、モジュール間の依存関係パスをマッピングしたりできます。

対象ユーザー

• 開発者：特にモノレポで作業している大規模なリポジトリで、高速かつ構造的なコードナビゲーションが必要な方。
• AIコーディングエージェント（例：Claude Code、Cursor、Geminiなど）：トークンを節約し、精度を向上させるために、生のファイルダンプではなく、コンパクトで解析可能な構造的コンテキストを必要とする方。

特徴

• 広範な言語対応：Kotlin、Java、Swift、Rust、TypeScript、Python、Go、C#など、多数の言語をサポート。
• エージェント最適化：全体のファイルではなく構造的なスライスを提供することで、エージェントのトークン使用量を40–50％削減。
• 高速性能：インポート、依存モジュール、クラスの検索においてgrepよりも大幅に高速（一部のベンチマークでは最大260倍の高速化）。
• 深いつながり：Claude Code、Cursor、Codex、Gemini CLI向けのプラグインとスキルを提供。
• 高度な分析：モジュール依存関係ルーティング、XML/リソース使用状況分析、iOS固有の構造的クエリなど、専門的なコマンドを備える。