コードベース全体を知識グラフ化！AI開発者のための最強分析ツール — GitNexus

abhigyanpatwari/GitNexusTypeScript25.6k

GitNexusは、プログラムのコード全体を分析して「知識グラフ（コード同士のつながりを地図のように可視化したもの）」を自動生成するツールです。CursorやClaude CodeなどのAIコーディング助手に、コードの構造・依存関係・実行の流れを正確に伝えることで、AIが見落としや間違った修正をしにくくなります。ブラウザだけで動くWeb版と、ローカルで動くCLI版の2つの使い方があり、どちらもコードを外部サーバーに送信しないためプライバシーも安心です。TypeScript、Python、Java、Goなど14言語に対応しており、個人の開発者からチーム開発まで幅広く活用できます。

🔥 なぜ話題？

CursorやClaude CodeなどAIコーディングツールが急速に普及する中、AIが「コードの全体構造を理解していない」という根本的な弱点を解決するツールとして注目を集めています。特にMCP（Model Context Protocol）を通じてAIエージェントに直接コンテキストを渡せる仕組みが、開発者の実務的な課題に刺さっている点が人気の理由です。

💡 こう使える！

たとえば、大規模なWebアプリで「ユーザー認証の関数名を変更したい」とAIに依頼したとき、通常のAIは関連する47個の依存先を見逃して壊れるコードを生成しがちですが、GitNexusを使えばAIが依存関係の全体像を把握した上で、影響範囲を一覧表示し、5ファイル8箇所を安全にまとめて修正してくれます。

ユースケース: AIコーディング助手を使った開発で、コードの依存関係や影響範囲を正確に把握し、安全な修正・リファクタリングを行いたい場面で使います。

コード全体の依存関係を知識グラフとして自動構築し、AIが見落としなく修正できるようになる
Cursor・Claude Code・Codex・Windsurf等の主要AIエディタとMCP連携可能
ブラウザ完結のWeb版とローカル完結のCLI版があり、コードを外部に送信しない安心設計
14のプログラミング言語に対応し、影響範囲分析・リネーム・Wiki生成など16種のAIツールを提供
従来のGraph RAGと異なり、インデックス時に構造を事前計算するため1回のクエリで完全な回答を返せる

GitHubで見る →

GitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a GitHub repo or ZIP file, and get an interactive knowledge graph wit a built in Graph RAG Agent. Perfect for code exploration

技術情報

言語

TypeScript

ライセンス

NOASSERTION

最終更新

2026-04-09

スター数

25,606

フォーク数

2,852

Issue数

260

技術詳細

アーキテクチャ・仕組み

GitNexusは多段階のインデックスパイプラインでコードベースの知識グラフを構築します:

構造解析 — ファイルツリーを走査し、フォルダ/ファイルの関係をマッピング
パース — Tree-sitter AST（抽象構文木）を使って関数・クラス・メソッド・インターフェースを抽出
解決 — インポート、関数呼び出し、継承、コンストラクタ推論、self/thisレシーバー型をファイル横断で解決
クラスタリング — Leiden法によるコミュニティ検出で関連シンボルを機能グループに分類
プロセス検出 — エントリーポイントから呼び出しチェーンを追跡し実行フローをトレース
検索インデックス — BM25 + セマンティック + RRF（Reciprocal Rank Fusion）のハイブリッド検索

主要技術スタック

レイヤー	CLI版	Web版
パース	Tree-sitter ネイティブ	Tree-sitter WASM
データベース	LadybugDB ネイティブ	LadybugDB WASM
埋め込み	HuggingFace transformers.js (GPU/CPU)	transformers.js (WebGPU/WASM)
可視化	—	Sigma.js + Graphology (WebGL)
フロントエンド	—	React 18, TypeScript, Vite, Tailwind v4
並行処理	Worker threads + async	Web Workers + Comlink

対応言語（14言語）

TypeScript, JavaScript, Python, Java, Kotlin, C#, Go, Rust, PHP, Ruby, Swift, C, C++, Dart

各言語でインポート解決、エクスポート検出、クラス継承、型注釈、コンストラクタ推論、フレームワーク検出、エントリーポイントスコアリングなどのサポートレベルが異なります。

MCP経由で提供される16のAIツール

query — ハイブリッド検索（BM25 + セマンティック + RRF）
context — シンボルの360度ビュー（参照、プロセス参加状況）
impact — 影響範囲分析（深度グルーピング・信頼度付き）
detect_changes — Git diffベースの影響マッピング
rename — グラフ+テキスト検索による複数ファイル一括リネーム
cypher — 生のCypherグラフクエリ実行
グループ系ツール5種（マルチリポジトリ横断検索等）

マルチリポジトリ対応

グローバルレジストリ（~/.gitnexus/registry.json）により1つのMCPサーバーで複数リポジトリを管理
LadybugDB接続は遅延オープン、5分間の非アクティブでエビクション（最大5同時接続）
gitnexus groupコマンドでリポジトリグループを作成し、マイクロサービス間の契約抽出・横断検索が可能

従来のGraph RAGとの違い

従来のGraph RAGはLLMに生のグラフエッジを渡して複数回クエリさせる方式。GitNexusはインデックス時にクラスタリング・トレース・スコアリングを事前計算するため、1回のツール呼び出しで完全なコンテキストを返せる。小規模LLMでも高精度な回答が可能。

セキュリティ・プライバシー

CLI版: 完全ローカル実行、ネットワーク通信なし
Web版: 完全ブラウザ内実行、コードはサーバーに送信されない
APIキーはlocalStorageのみに保存

ライセンス・商用利用

PolyForm Noncommercial 1.0.0 ライセンス（非商用利用向け）
商用利用やエンタープライズ（SaaS / セルフホスト）は akonlabs.com にて提供
エンタープライズ版にはPRレビュー自動化、自動再インデックス、マルチリポ統合グラフ、OCaml対応等が含まれる

制約・注意点

Web版はブラウザメモリの制約により約5,000ファイルまで（バックエンドモード使用で無制限）
Web版のデータはセッション単位のインメモリ（永続化なし）
仮想通貨・トークンとの関連は一切なし（詐欺警告あり）

開発ロードマップ

LLMによるクラスタ名のセマンティック付与
ASTデコレータ検出（@Controller, @Get等）
インクリメンタルインデックス（変更ファイルのみ再インデックス）

インストール・クイックスタート

CLIのインストールと基本的な使い方

# リポジトリのルートディレクトリで実行するだけでインデックスが作成されます
npx gitnexus analyze

エディタへのMCP設定を自動で行うには:

npx gitnexus setup

グローバルインストールする場合:

npm install -g gitnexus

Web UIをローカルで動かす場合

git clone https://github.com/abhigyanpatwari/gitnexus.git
cd gitnexus/gitnexus-shared && npm install && npm run build
cd ../gitnexus-web && npm install
npm run dev