Table of Contents
TL;DR
Graphify turns your codebase and related content into a searchable knowledge graph, giving AI coding assistants persistent context instead of making them repeatedly scan files. This can improve context quality, speed up responses, and reduce token usage, while keeping most processing local.
Executive summary
AI coding assistants are only as good as the context they can see. Today, they repeatedly re‑read your entire codebase, burning tokens and time on every query. This is a hidden tax we call Context Exhaustion.
Graphify, a free, open‑source knowledge‑graph skill for tools like Claude Code, Cursor, and GitHub Copilot, replaces this wasteful pattern with a persistent memory layer, where your project is converted into a navigable knowledge graph that the AI can query instead of re‑scanning raw files.
Teams using Graphify report up to 70x token reductions and much faster, more accurate answers, making their existing AI stack both significantly smarter and dramatically cheaper to run.
Introduction
If you have ever used an AI coding assistant like Claude Code, Cursor, or GitHub Copilot, you have probably noticed something annoying.
Every time you ask a question about your project, the AI starts opening files, scanning code, and reading the same things over and over again. It is slow. It uses a lot of tokens (which can cost money). And sometimes the AI still misses the bigger picture.
Wishtree’s implementation guide introduces Graphify, a focused response to this problem.
Instead of treating your project as a loose pile of files, Graphify builds a knowledge map that persists across sessions and tools, so your AI spends its time navigating structure and meaning, rather than rediscovering it from scratch.
The result is a development environment where AI feels less like a clever autocomplete and more like a teammate that genuinely understands your codebase.
What is Graphify? (and who built it?)
Graphify is a free, open‑source skill that turns any folder, be it code, SQL schemas, docs, PDFs, research papers, images, videos, and audio – into a queryable knowledge graph.
This represents a powerful application of graph-based data modeling for AI context management.
- Every function, file, document, and concept becomes a node.
- Every relationship between them becomes an edge.
- Your AI assistant reads this compact graph instead of raw files.
Graphify was created by Safi Shamsi and is maintained at the GitHub repo [safishamsi/graphify].
It sits under the broader Graphify Labs umbrella and has rapidly grown into one of the most popular knowledge‑graph helpers for coding AI, with tens of thousands of GitHub stars and frequent releases.
The official package is published on PyPI as graphifyy (double “y”), is licensed under MIT, and runs locally on your machine.
In practice, that means you get a powerful, privacy‑respecting context engine for your AI tools, and at zero license cost.
What is Graphify best used for?
Graphify shines whenever your project is too large or too multimodal for an AI model to “see” everything at once.
Key scenarios
- Understanding a new codebase fast
Joining a new team with a massive monorepo? Graphify maps the project structure, dependencies, and hotspots in minutes, giving you an architectural overview that would otherwise take weeks. - Capturing the why behind code
Comments like # WHY, # HACK, and scattered design notes in docs become first‑class graph nodes. This makes rationale searchable instead of buried. - Connecting mixed content
Code, technical specs, research PDFs, diagrams, screenshots, and video transcripts all live in the same graph, so your AI can answer questions that cross file types. - Saving serious money on tokens
How? By letting the model query a compact graph instead of raw sources, prompts shrink dramatically, reducing token usage and latency. - Persistent project memory
The graph is stored on disk, surviving chat resets, editor restarts, and even tool changes. Well, the context you build up once is reused indefinitely. - Finding hidden connections
Using Leiden community detection, Graphify surfaces “god nodes” – highly connected files or concepts, and non‑obvious relationships that matter for refactors and onboarding.
If your work goes beyond small, single‑file scripts, Graphify is designed for you.
The 3‑pass architecture: how Graphify “sees” your project
Unlike simple text search or embedding‑only approaches, Graphify builds its map in three privacy‑aware passes.
1. Deterministic AST extraction (local & free)
Graphify uses tree‑sitter to parse source code across more than 20 languages (Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, Ruby, PHP, Swift, Kotlin, and others). This pass:
- Extracts functions, classes, imports, call graphs, and dependencies.
- Runs entirely on your machine with no AI and no network calls.
- Forms the structural skeleton of the knowledge graph.
2. Local audio/video transcription (local)
For spoken content like walkthroughs, demos, recorded stand‑ups – Graphify uses faster‑whisper or similar local engines to generate transcripts.
- Transcription happens locally, and media never leaves your environment.
- Transcripts are attached to relevant code or docs. These enrich the graph with human context.
3. Semantic relationship extraction (AI‑powered)
Here, an LLM analyzes docs, screenshots, comments, and transcripts to extract concepts, entities, and relationships that static parsing misses.
- Captures business rules, architectural decisions, and “why this exists” stories.
- Links loosely structured content (for example, design doc paragraphs) to specific components in your code.
The outcome: a unified map combining structure (Pass 1), human context (Pass 2), and meaning (Pass 3). Your AI assistant can navigate this. It does not have to rebuild from raw text every time.
Core features that make Graphify special
Graphify combines several thoughtful design choices that make it more than just another indexer.
1. Three smart passes
The AST, transcription, and semantic passes give the model a layered understanding, with syntax, discussion, and intent – rather than just tokenized text.
2. Honest confidence labels
Every edge in the graph is labeled:
- EXTRACTED – Found directly in code or docs (ground truth).
- INFERRED – An AI‑generated relationship with a 0.0-1.0 confidence score.
- AMBIGUOUS – Flagged for human review.
This lets you and your AI distinguish facts from educated guesses.
3. Multimodal support
Graphify ingests code, PDFs, markdown, images, audio, video, and even external content like YouTube URLs, tying them into a single graph.
4. Incremental updates
A SHA256 cache ensures only changed files are reprocessed, so updates are fast and cheap instead of full rescans.
5. Privacy‑friendly defaults
Code parsing and transcription are strictly local. Only the optional semantic pass talks to an external LLM, and you control which model and keys are used.
6. “God nodes” & community detection
Using the Leiden algorithm, Graphify finds central nodes and communities that reveal system hotspots, service boundaries, and potential refactor risk areas.
7. Persistent memory on disk
Graph outputs are written to disk (for example, graphify-out/ and a JSON graph), so your AI tools can reuse them across sessions and commits.
8. Broad assistant support
Graphify works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot CLI, VS Code Copilot Chat, OpenCode, Aider, OpenClaw, Factory Droid, Trae, Hermes, and Google Antigravity, among others.
Why Graphify is a 2026 must‑have tool
A quick capability–benefit table based on the 2026 docs:
| Feature | What it does | Why it matters |
| Knowledge graph | Maps every file, function, and concept as nodes and edges | AI navigates structure instead of blind searching |
| Persistent memory | Keeps graphs on disk across sessions | No context loss between chats or tools |
| 3‑pass architecture | Combines AST, transcripts, and semantic relationships | Gives a complete picture: structure + context + intent |
| Confidence labels | Tags edges as EXTRACTED / INFERRED / AMBIGUOUS | You see what is fact and what needs review |
| Leiden detection | Finds “god nodes” and communities | Faster onboarding and safer refactoring |
| Incremental updates | Re‑processes only changed files via SHA256 cache | Fast updates, low compute and API cost |
| Privacy‑first design | Keeps parsing and transcription local | Protects sensitive code and data by default |
Massive cost savings: the token math
Context Exhaustion is both annoying and expensive.
Without Graphify, each query can consume tens or hundreds of thousands of tokens. This is a hidden cost in any AI stack optimization effort that most organizations fail to measure until they see the API bill.
With enterprise pricing, that cost scales quickly with team size and query volume.
Community benchmarks and walkthroughs show that when assistants read compact graph summaries instead of raw code, token usage per query drops from the 50,000–200,000 range to roughly 700–7,000 tokens.
That is a reported up to 71.5x reduction in token usage. This means that the same API budget can support far more queries and more developers.
For a team of 20+ engineers who rely on AI assistants daily, this can translate into thousands of dollars saved per month in API spend, while simultaneously improving responsiveness and answer quality.
This, then, is a key benefit of cost-efficient AI infrastructure where token optimization directly impacts the bottom line.
How to install Graphify (step by step)
Before you begin, make sure:
- You have Python 3.10+ installed.
- pip (or an equivalent like uv or pipx) works in your terminal.
- At least one supported AI coding assistant is installed.
1. Install the Python package
Important: The PyPI package is spelled graphifyy with a double “y”.
pip install graphifyy
If you hit graphify: command not found, the docs suggest using uv tool install graphifyy or pipx install graphifyy, or adding the installed script directory to your PATH.
2. Run the install command for your assistant
The default command wires Graphify into Claude Code on Linux/Mac:
graphify install
After this, you can use /graphify in Claude Code to build a graph of the current folder.
Always‑on mode: Running graphify install injects graph awareness into system prompts so your assistant automatically leverages the graph, even if you forget to call it explicitly.
Install commands for other AI tools
If you are using a different AI assistant, use the matching command:
| Platform | Install command |
| Claude Code (Linux/Mac) | graphify install |
| Claude Code (Windows) | graphify install –platform windows |
| Codex | graphify install –platform codex |
| OpenCode | graphify install –platform opencode |
| GitHub Copilot CLI | graphify install –platform copilot |
| Aider | graphify install –platform aider |
| Gemini CLI | graphify install –platform gemini |
| Cursor | graphify cursor install |
| Google Antigravity | graphify antigravity install |
This list continues to evolve. Always check the README for the newest platforms and flags.
How to trigger Graphify
Once installed, you trigger graph building and queries from inside your assistant or the CLI.
Common commands:
| Command | What it does |
| /graphify . | Build a graph of the current folder |
| /graphify ./my-project | Build a graph for a specific folder |
| /graphify ./my-project –update | Only re‑process files that changed |
| graphify query “what connects X to Y?” | Ask a targeted question against the existing graph |
For Codex, the prefix is $graphify . instead of /graphify .
The strategic move: stop grepping, start mapping
By 2026, the productivity gap between expert and average developers is increasingly about how well they manage AI context, not just how fast they type. Manual grepping and per‑query file scanning are 2022‑era habits.
- The old way:
You and your AI assistant both grep, open files manually, and reassemble mental models from scratch. - The Graphify way:
The AI starts from a pre‑built knowledge map and navigates directly to relevant nodes and relationships.
This shift from per‑query context building to persistent knowledge represents AI asset management – treating project understanding as a reusable asset that compounds in value rather than a cost incurred on every interaction.
The Wishtree partnership: smarter AI, faster delivery
At Wishtree, we focus on optimizing the workflows around AI tools.
Graphify complements AI-powered development workflows where autonomous systems handle context retrieval, letting engineers focus on architecture and problem-solving rather than manual file navigation.
How Wishtree can help you as a partner:
- Assess how your teams currently use AI assistants and quantify token waste and latency from Context Exhaustion.
- Help you install, configure, and integrate Graphify with your chosen assistants and CI/CD, including multi‑repo setups.
- Design graphs that span multiple repositories and services, aligning with your domains and architecture.
- Teach teams advanced Graphify usage: querying strategies, community detection, and integrating graph context into custom agents and tooling.
The AI that knows your code
In 2026, context quality is the only differentiator. The AI assistant that wins is the one that understands your codebase, documents, and decisions better than any generic model ever could.
Graphify gives your existing AI tools that advantage by turning your repositories into a persistent, multimodal knowledge map, that too without sending your code to anyone and without adding license costs. Instead of re‑reading the same files, your AI navigates structure, rationale, and relationships directly.
If you want your developers to ship faster while spending less on tokens, the next step is to stop letting your AI “read” in circles.
Give it a map.
Reach out to Wishtree to explore how Graphify and knowledge graphs can fit into your engineering and AI strategy.
FAQs
Is Graphify really free?
Yes. Graphify is released under the MIT open‑source license, so you can use, modify, and redistribute it commercially with no license fees. The only potential costs are LLM API calls for the semantic extraction pass (Pass 3), which runs using your own keys.
Does my code leave my machine when I use Graphify
No, unless you explicitly enable the semantic extraction pass with a remote model. AST parsing (Pass 1) and audio/video transcription (Pass 2) are local‑only by default.
What is the deal with the double “y” ingraphifyy?
The official PyPI package is graphifyy (two “y”s); other similarly named packages are not affiliated. The CLI command remains graphify.
How much token savings can I really expect?
Users report up to 71.5x reductions in token usage, with queries shrinking from 50k-200k tokens down to 700-7k tokens by reading graph summaries instead of raw code. For teams of 20+ devs, this often means thousands of dollars saved monthly.
Does Graphify work with my AI assistant?
Graphify supports a wide range of coding assistants, including Claude Code, Cursor, GitHub Copilot CLI, Codex, Gemini CLI, VS Code Copilot Chat, OpenCode, Aider, OpenClaw, Factory Droid, Trae, Hermes, and Google Antigravity.
What languages does Graphify support for code parsing?
Using tree‑sitter, Graphify can parse more than 20 languages, including Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, PHP, Ruby, Swift, Kotlin, and others; if a language has a tree‑sitter grammar, it is likely supported.
Can I use Graphify on an existing codebase without slowing down work?
Yes. The first run may take a few minutes on large repos, but thanks to SHA256‑based incremental updates, subsequent runs re‑process only changed files and typically finish in seconds.
What are “god nodes” and why do they matter?
“God nodes” are highly connected files or components that many others depend on. Identifying them helps new developers onboard and guides safer refactoring.
How do I know if a graph connection is reliable?
Edges carry confidence labels.
EXTRACTED (direct evidence), INFERRED (AI‑generated with a numeric confidence), or AMBIGUOUS (needs review).
This transparency lets you and your AI weigh relationships appropriately.
How can Wishtree help my team adopt Graphify?
Wishtree offers implementation, workflow integration, and training services, and can extend Graphify with custom knowledge‑graph pipelines tailored to your architecture, domains, and AI roadmap.






