harshkedia177/axon

何を解決するか

Axonはコードベースの構造的知識グラフを作成し、変更による破壊を防ぎ、開発者およびAIエージェントの認知的負荷を軽減します。AIエージェントが「平らなテキスト」（文字列のgrep）で作業するという問題を解決します。これにより、間接的な依存関係を見逃すことが多く、コードが実際にどのように接続されているかの理解が不足するという問題が生じます。

動作方法

Axonはローカルで実行される12段階の分析パイプラインを使用してリポジトリをインデックス化します。tree-sitterを用いてASTを抽出し、インポートを解決し、関数呼び出しをトレースし、型関係を分析します。その後、Leidenアルゴリズムを用いてコミュニティ検出を行い、git履歴を分析して「変更結合」（頻繁に一緒に変更されるファイル）を特定します。このデータはグラフに格納され、Webダッシュボード、CLI、またはMCP（Model Context Protocol）サーバーを通じて照会可能です。AIエージェントはハイブリッド検索（BM25 + ベクトル + ファジー）と影響範囲分析を実行できます。

対象ユーザー

• AIエージェント開発者：Claude CodeやCursorなどのエージェントに、コンテキストウィンドウに詰め込むことなく、深いアーキテクチャ認識を提供したい人。
• ソフトウェアエンジニア：コールグラフを可視化したり、不要コードを検出したり、リファクタリング前の影響範囲分析を行いたい人。

特徴

• インタラクティブなWeb UI：コミュニティの輪郭を重ねた力学的グラフ可視化と、Cypherクエリコンソール。
• MCP統合：axon_impactやaxon_contextなどのツールを公開し、エージェントが1回のツール呼び出しで依存関係を理解できるようにします。
• 深層分析：フレームワークに特化した不要コード検出と実行フローのトレース（例：FastAPIやExpressのルートを検出）。
• Git結合：git履歴を分析して、隠れた依存関係（一緒に変更されるファイル）を特定します。
• ローカル優先：すべての解析、埋め込み、グラフストレージがクラウド依存なしにローカルで実行されます。