Currently free — no license key required

Give your AI a map of your codebase.

GrapeRoot builds two semantic graphs of your project — locally — so Claude Code and Codex CLI understand your code before writing a single line. Includes token cost tracking out of the box.

100% Local & PrivateClaude CodeCodex CLIToken Counter BundledZero ConfigmacOS · Linux · Windows
Get Started FreeView Setup Guide→

Have questions or feedback? Get in touch →

Terminal — GrapeRoot

$ dgc .

 

Scanning codebase...

████████████████ 847 files

 

Building Info Graph...... ✓

Building Action Graph.... ✓

Starting MCP Server..... ✓

 

Server localhost:8765

Client Claude Code ⟵ connected

 

Your AI now knows your codebase.

$ ▋

How it works

From zero to AI superpowers in one command

No config files, no API keys, no cloud setup. Just point GrapeRoot at your project and go.

1

Run one command

Run `dg .` for Codex CLI or `dgc .` for Claude Code from inside your project directory. That's the entire setup.

$dgc .
2

Graphs are built locally

GrapeRoot scans your project and constructs two semantic graphs: an Info Graph (what code does) and an Action Graph (what changed and why).

$Building Info Graph... ✓
3

Local MCP server starts

A lightweight MCP server starts on your machine on an auto-selected free port. Zero configuration, no cloud connection.

$MCP Server → localhost:8765
4

AI connects automatically

Claude Code or Codex CLI detects the local MCP server and connects automatically. No manual configuration needed.

$Claude Code ⟵ connected
5

Every query gets smarter

GrapeRoot ranks files by relevance to each AI query and injects the perfect context — reducing hallucinations and wasted tokens.

$Context enriched. Ready.

Features

Everything your AI needs to actually understand your code

Built for developers who want AI that works like a senior engineer, not a search engine.

Local & Private

Your source code never leaves your machine. All graph processing happens 100% locally.

Works with Claude Code

Seamlessly integrates with Anthropic's Claude Code CLI via the MCP protocol.

Works with Codex CLI

Full support for OpenAI's Codex CLI. Requires a ChatGPT Pro or Plus account.

Live Token Usage

Token Counter MCP ships with every install — track exact input, output, and cache tokens with live USD cost per session in a real-time dashboard.

Auto Compact

GrapeRoot hooks into Claude Code's compact event to automatically re-prime context — your AI never loses track of your codebase after a conversation reset.

Smart Context Retrieval

GrapeRoot ranks and retrieves only the files and symbols relevant to each query.

Auto Port Selection

Finds a free port automatically. No config files, no environment variables needed.

One-Time Install

Install once via Homebrew or Scoop, then run on any project instantly.

Cross-Platform

Full support for macOS, Linux, and Windows. Consistent experience everywhere.

See it in action

Watch GrapeRoot in action

See how GrapeRoot enriches every AI query with perfect codebase context — in real time.

Installation

Install in minutes

One-time global install. Then run on any project with a single command.

Step 1 — Global install

bash
1# 1. Homebrew  (skip if already installed)
2/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
4eval "$(/opt/homebrew/bin/brew shellenv)"
5# 2. Python + Node  (skip if already installed)
6brew install python@3.11 node
7# 3. Claude Code  (skip if already installed)
8npm install -g @anthropic-ai/claude-code
9# 4. Dual-graph
10brew tap kunal12203/tap
11brew install dual-graph
12dual-graph-install
13source ~/.zshrc

Step 2 — Run on your project

shell
1dg  "path/to/your/project"# Codex CLI (OpenAI)
2dgc "path/to/your/project"# Claude Code (Anthropic)

Run once per project — before launching your AI assistant. Use dg for Codex CLI and dgc for Claude Code.

Pricing

Simple, honest pricing

Free today. No credit card, no account, no catch.

Free — no license key required
Free
$0

No credit card. No account. No catch.

  • Full context graphs (Info + Action)
  • Works with Claude Code
  • Works with Codex CLI
  • No license key needed
  • macOS, Linux & Windows
  • Auto port selection
  • Token Counter MCP bundled
  • Community support
Get Started Free

The AI model itself (Claude / ChatGPT) is billed separately by Anthropic / OpenAI.

Be the first to know & grow

Interested in GrapeRoot Pro or have feedback? Fill the form — we read every message and will reach out personally.

No spam, ever. We'll only reach out if we have something meaningful to share.