Give your AI a map of your codebase.
GrapeRoot gives Claude Code and Codex a deep understanding of your project before they write a single line. Less re-reading, fewer hallucinations, and real-time token cost tracking built in.
Have questions or feedback? Get in touch →
$ dgc .# Claude Code
$ dg .# Codex
Scanning codebase...
████████████████ 847 files
Building Info Graph...... ✓
Building Action Graph.... ✓
Starting MCP Server..... ✓
Server ready
Token tracking live
AI assistant connected
Your AI now understands your codebase.
$ ▋
Installation
Install in minutes
One-time global install. Then run on any project with a single command.
Step 1 — Global install
1# One-line install (handles Python, Node, Claude Code / Codex automatically)2curl -sSL https://raw.githubusercontent.com/kunal12203/Codex-CLI-Compact/main/install.sh | bash3source ~/.zshrc
Run on your project
After installing, open a new terminal and run this command inside your project folder. This is what actually connects GrapeRoot to your AI.
dgc "path/to/your/project"# Claude Codedg "path/to/your/project"# Codex
Run this every time you start a project session with Claude Code or Codex.
Join the GrapeRoot Community
Connect with other developers, share your feedback, and get help configuring GrapeRoot for your specific codebase. We'd love to hear how you use it!
Join Discord ServerSee it in action
Watch GrapeRoot in action
See how GrapeRoot enriches every AI query with perfect codebase context — in real time.
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.
Run one command
Run `dgc .` (Claude Code) or `dg .` (Codex) from inside your project directory. That's the entire setup.
Your codebase is mapped
GrapeRoot scans your project and builds a complete understanding of your files, functions, and how they connect.
Everything starts locally
A lightweight server starts on your machine. Your code never leaves your computer — everything runs 100% locally.
Your AI connects
Claude Code or Codex automatically picks up GrapeRoot — no manual configuration needed. Token tracking starts immediately.
Every question gets smarter
GrapeRoot sends only the relevant files to your AI and gets better with every question. Less hallucination, lower cost.
Architecture
Two graphs. One clear picture.
GrapeRoot builds a semantic map of your code and a memory of your session — then uses both to route your AI to exactly the right context, every turn.
What your code does
Maps every file, function, and connection in your project. When you ask a question, GrapeRoot knows exactly which files matter — so only the right context gets sent to your AI.
- Understands your project structure
- Knows how files connect to each other
- Sends only what's relevant to your question
What happened so far
Remembers every file your AI read and edited during the session. After the first question, your AI goes straight to the right files — no re-reading, no wasted tokens.
- Remembers what was read and changed
- Picks up where you left off
- Each question gets faster and cheaper
Session Flow
Gets smarter every turn
Your AI explores the codebase normally. GrapeRoot quietly learns which files matter and how they connect.
GrapeRoot remembers what was touched and routes your AI directly to the right files — no re-reading, no wasted tokens.
Your AI knows your codebase deeply. Each question is faster, cheaper, and more accurate than the last.
MCP Tools
What powers your AI
GrapeRoot gives your AI a set of capabilities that work together behind the scenes — no configuration needed.
Smart Routing
Automatically directs your AI to the most relevant files based on what it already knows.
Budget-Aware Reading
Reads only the parts of files that matter — specific functions, not entire files — saving tokens.
Edit Tracking
Logs every change so your AI always works with the latest version of your code.
Relevance Scoring
Ranks every file by how relevant it is to your current question.
Dependency Awareness
Understands how your files connect so your AI can assess the impact of changes.
Impact Analysis
After edits, surfaces connected files that might be affected — catching issues early.
Session Insights
See what your AI read, changed, and decided during the session.
Fully automatic
GrapeRoot configures everything automatically when you run dgc . or dg . — it sets smart limits on how much your AI reads per turn, prevents unnecessary file scanning, and keeps token usage low. You never configure this manually.
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 & Codex
Seamlessly integrates with Anthropic's Claude Code and OpenAI's Codex CLI via the MCP protocol.
Live Token Usage
Track your token usage and costs in real-time with a built-in dashboard. See exactly what each session costs you.
Auto Compact
When Claude resets its context mid-conversation, GrapeRoot automatically re-primes it — your AI never loses track of your codebase.
Smart Context Retrieval
Only the files relevant to your question are sent to the AI. No noise, no wasted tokens.
Zero Configuration
No config files, no environment variables, no API keys. Everything just works out of the box.
One-Time Install
Install once with a single command, then run on any project instantly. Auto-updates included.
Cross-Platform
Full support for macOS, Linux, and Windows. Consistent experience everywhere.
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.