defendend/Claude-ast-index-search

解決する課題

ast-index は、大規模かつ多言語のリポジトリ向けに設計された構造化コードナビゲーションCLIです。不正確な「grepスタイル」のテキスト検索を、AST（抽象構文木）対応のインデックスに置き換えることで、開発者やAIエージェントが単純なテキスト一致ではなく、クラス、関数、継承関係といった正確な構造に基づいてコードをナビゲートできるようにします。

仕組み

このツールは、シンボル、参照、インポート、モジュール、依存関係のローカルSQLiteインデックスを構築します。Kotlin、Java、Rust、Python、Go、C++など、幅広い言語をサポートしています。ユーザーは rebuild でインデックスを構築し、update で最新の状態に保つことができます。

AIエージェントに対しては、生のファイルダンプではなく、コンパクトで解析可能な構造化されたコードスライスを提供するため、大規模リポジトリにおいてトークン使用量を40〜50%削減できます。また、プラグインやスキルを通じて、Claude Code、Cursor、Gemini CLIなどのAIツールと統合可能です。

対象ユーザー

• 開発者: 大規模なモノレポや多言語プロジェクトで、シンボルや依存関係を高速かつ正確にナビゲートする必要がある方。
• AIエージェント開発者: コーディングエージェントに、コードベースに関する高精度かつ低トークンなコンテキストを提供したい方。

主な特徴

• AST対応ナビゲーション: 数十種類の言語にわたり、定義、使用箇所、呼び出し元、実装へ直接ジャンプできます。
• エージェントの最適化: 構造化されたコードスライスを返すことで、トークンを節約し、LLMにより良いコンテキストを提供します。
• Git統合インサイト: hotspots コマンドにより、変更頻度、バグ修正数、作成者数に基づいてファイルをランク付けし、不安定なコードを特定できます。
• シンボルグラフ: シンボル間の依存関係グラフを構築し、影響分析、循環参照の検出、最も中心的なシンボルの特定を行います。
• 高性能: 大規模プロジェクトにおいて、インポート、依存関係、クラスを検索する際、grepよりも大幅に高速です。
• モノレポサポート: ネストされたプロジェクトマーカーやルートをまたぐワークスペース向けの特定のワークフローが含まれています。