README_ja.md

 ▄▀▀▀ █▀▀▄ ▄▀▀▄ █▀▀█ █▀▀▀ █▀▀▄ ▄▀▀▄ ▄▀▀▄ ▀█▀
 █ ▀▄ █▄▄▀ █▄▄█ █▄▄█ █▀▀  █▄▄▀ █  █ █  █  █
 ▀▀▀▀ ▀ ▀▀ ▀  ▀ █    ▀▀▀▀ ▀ ▀▀ ▀▀▀▀ ▀▀▀▀  ▀

GrapeRootとは？

GrapeRoot はオープンソースのコンテキストエンジンです。あなたとAIコーディングアシスタントの間に入り、コードベースのセマンティックグラフ（ファイル・シンボル・インポート・呼び出しチェーン）を構築して、AIがプロンプトを受け取る前に最適なコードを正確にプリロードします。

その結果、AIはトークンを推論に使えるようになり、コード探索に無駄遣いしなくなります。

You run: dgc /path/to/project
              ↓
1. Project scanned → semantic graph built (files, symbols, imports)
2. You ask a question
3. Graph identifies the relevant files → packs them into context
4. AI gets your question + the right code already loaded
5. Fewer turns, fewer tokens, better answers

トークン削減効果はセッション全体で複利的に積み上がります。グラフは読み込んだファイル・編集したファイル・クエリしたファイルを記憶しており、ターンを重ねるほどコストが下がっていきます。

結果

複数の実際のコードベース（7,700以上のファイル）と50以上のエンジニアリングプロンプトでベンチマーク：

タスクタイプ別のコスト削減

節約効果はセッション全体で複利的に積み上がります——ターン3で回避したトークンは、その後の全ターンでのキャッシュ再請求も回避できます。上記のすべてのタスクタイプで品質は同等以上を維持します。

詳細なベンチマーク方法と結果：graperoot.dev/benchmarks

対応AIツール

対応プログラミング言語

TypeScript · JavaScript · Python · Go · Swift · Rust · Java · Kotlin · Scala · C# · Ruby · PHP

インストール

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash
source ~/.zshrc   # or ~/.bashrc / ~/.profile

Windows (PowerShell):

irm https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.ps1 | iex

Windows (Scoop):

scoop bucket add dual-graph https://github.com/kunal12203/scoop-dual-graph
scoop install dual-graph

前提条件： Python 3.10+、Node.js 18+、および対応AIツールのいずれか。インストーラーが不足しているツールを検出し、自動インストールを提案します。

使い方

重要： MCPサーバーを確実に起動するため、claude を直接使わず常に dgc を使用してください。

Claude Code

dgc                                      # scan current directory, launch Claude
dgc /path/to/project                     # scan a specific project
dgc /path/to/project "fix the login bug" # start with a prompt

OpenAI Codex CLI

dg                              # scan current directory
dg /path/to/project             # scan a specific project
dg /path/to/project "add tests" # start with a prompt

インタラクティブピッカー（v3.9.99で新登場）

graperoot          # shows directory confirm + arrow-key tool picker
graperoot .        # same, picks from current directory
graperoot --version   # print current version
graperoot --update    # force self-update

graperoot で全ツールを起動

graperoot . --cursor          # Cursor
graperoot . --gemini          # Gemini CLI
graperoot . --opencode        # OpenCode
graperoot . --copilot         # GitHub Copilot
graperoot . --openclaw        # OpenClaw
graperoot . --kilocode        # Kilocode
graperoot . --mimocode        # MiMo Code
graperoot /path --gemini "add tests"   # specific project + prompt

Windows

dgc .                          # from inside the project directory
dgc "D:\projects\my-app"       # any drive, any path
dg "C:\work\backend"           # Codex CLI
dgc --gemini "D:\projects\app" # Gemini CLI on Windows

仕組み

1. グラフスキャン — 初回実行時に、GrapeRoot はファイル・関数・クラス・インポート関係を .dual-graph/ に保存されたローカルグラフとして抽出します。
2. コンテキスト取得 — 質問のたびにグラフが最も関連性の高いファイルをランキングし、AIがプロンプトを受け取る前にそれらをコンテキストへパックします。
3. セッションメモリ — 読み込み・編集・クエリしたファイルは以降のターンで優先度が上がります。コンテキストが複利的に蓄積されます。
4. MCPツール — AIはさらに深く探索が必要な場合、グラフ対応のツール（graph_read、graph_retrieve、graph_neighbors）を利用できます。

処理はすべてローカルで行われます。コードがマシン外に出ることはありません。

データとファイル

すべてのデータは <project>/.dual-graph/ に保存されます（.gitignore に自動追加）：

グローバルインストール先 ~/.dual-graph/：

設定

すべて任意の環境変数で設定できます：

自動アップデート

ランチャーは起動のたびにアップデートを確認し、サイレントで自動更新します。手動で強制アップデートするには：

graperoot --update

自動アップデートを無効にするには：

graperoot --no-auto-update

再度有効にするには：

graperoot --auto-update

現在のバージョン：3.10.16

テレメトリ

GrapeRoot はバグ修正のために匿名のクラッシュレポートを収集します。送信される情報：エラーの種類、失敗したステップ、OS/Pythonバージョン、GrapeRootバージョン。送信されない情報：コード、ファイルパス、プロジェクト名、個人データ。

graperoot --no-telemetry    # disable
graperoot --telemetry       # re-enable

GrapeRoot Pro

GrapeRoot Pro はパワーユーザー向けの高度な機能を追加します：

• 徹底的なタスクモード — 複雑なリファクタリングのための深いマルチファイル分析
• デッドエクスポート検出 — コードベース全体で使われていないエクスポートを発見
• 依存関係サイクル検出 — 循環インポートチェーンを検出
• クロスコードベース検索 — 複数のリポジトリをまたいだセマンティック検索
• アンドゥシールド — 破壊的な操作を防ぐプレツール実行フック

トラブルシューティング

「MCP Server Connection Failed」（MCPサーバー接続失敗）

claude を直接使わず、常に dgc を使用してください。dgc はMCPサーバーを自動起動します。

# Fix:
claude mcp remove dual-graph
dgc   # re-registers everything

詳細なトラブルシューティングガイド

TROUBLESHOOTING.md または graperoot.dev/docs を参照してください。

コントリビューション

ランチャースクリプト（bin/）はApache 2.0ライセンスのオープンソースです。バグ修正・新しいAIアシスタントサポート・インストール改善・ドキュメントなど、PRを歓迎します。

注意： グラフエンジン（graperoot pipパッケージ）はプロプライエタリです。このリポジトリのランチャーとツールは完全なオープンソースです。

コミュニティ

質問がある、バグを見つけた、フィードバックを共有したい方は：

Discordに参加する →

スター履歴

ライセンス

このリポジトリのランチャースクリプトとツール：Apache License 2.0

graperoot グラフエンジン（PyPI）：プロプライエタリ。graperoot.dev/graperoot-pro を参照してください。