nervx: CLIツールは、コードベースの構造を分析することでClaude Codeのトークン使用量を削減します

nervxの機能

nervxは、Claude Codeの非効率なコードベースナビゲーションに対処するCLIツール（pipインストール可能）です。開発者は、Claudeが単純なクエリでも過剰なgrep検索（60回以上）を行い、ファイルを再読み込みして、実際の作業を開始する前にコンテキストウィンドウの半分を消費することを観察した後、このツールを構築しました。

仕組み

このツールはtree-sitterを使用してリポジトリ全体を解析し、すべての関数、クラス、呼び出しチェーン、インポートのSQLiteグラフを構築し、プロジェクトの構造マップを含むNERVX.mdファイルを生成します。このマップには、エントリーポイント、実行フロー、ホットファイル、脆弱なコードが含まれます。

重要な機能：nervx build .を実行すると、CLAUDE.mdファイルにnervxの使用方法をClaudeに教える指示が自動的に追加されます。Claudeはその後、grepの前に独自にnervx navを実行し、リファクタリング前に影響範囲を確認し、一般的に手動のプロンプトなしでより効率的にナビゲートします。

技術詳細

• MCPサーバー設定は不要
• APIキーは不要
• ビルドプロセス中にLLM呼び出しはなし
• 純粋なtree-sitter + git実装
• 5秒以内にビルド
• 分析のためのLLMコストはゼロ

パフォーマンス結果

FastAPIリポジトリで同じ3つの質問でテスト：

• ツール呼び出し：93 → 56（-40%）
• 出力トークン：15,694 → 8,196（-48%）
• Grep検索：63 → 22（-65%）

追加機能

• デッドコードを検出
• 呼び出し元がエラーハンドリングで不一致の関数をフラグ
• グラフ形状からファクトリーやイベントバスなどのパターンを検出
• 生成されたグラフの可視化を含む
• Python、JS/TS、Java、Go、Rust、C/C++、C#、Rubyをサポート

他のツールとの違い

開発者は、グラフ生成にLLMを使用するアプローチやMCP設定を必要とするアプローチを特に避け、トークン浪費問題を解決するためにさらにトークン使用量を増やさないように、純粋な静的解析に焦点を当てました。