Graphify
Updated
Turn any folder of code, SQL schemas, R scripts, shell scripts, docs, papers, images, or videos into a queryable knowledge graph. App code + database schema + infrastructure in one graph.
uv tool install graphifyy && graphify install pipx install graphifyy && graphify install pip install graphifyy && graphify install What it does
Pointing an agent at a large codebase or document pile means re-reading the same files for every question — which burns through tokens fast. Graphify scans the folder once, extracts concepts and relationships into a knowledge graph, and routes future queries through the graph. The repo claims 71.5× fewer tokens per query versus reading raw files on large corpora.
Usage examples
After install, the /graphify family of slash commands builds the graph, queries it, and pulls in external sources.
# 1. Build a graph — current folder or any specific path
/graphify .
/graphify ./raw # run on a specific folder
# 2. Ask what connects two concepts
/graphify query "what connects attention to the optimizer?"
# 3. Trace the path between two nodes
/graphify path "DigestAuth" "Response"
# 4. Explain a concept in graph context
/graphify explain "SwinTransformer"
# 5. Add an external source (paper, webpage) to the graph
/graphify add https://arxiv.org/abs/1706.03762 # fetch a paper, save, update graph
The headline workflow is the Andrej Karpathy /raw folder pattern that the README cites — a single folder of papers, tweets, screenshots, and notes that graphify merges into one queryable graph. Once it’s built, “what connects attention to the optimizer?” or “trace DigestAuth to Response” run against the graph instead of re-reading raw files. That’s where the token savings come from.
Key features
-
Multimodal input
Code, SQL schemas, R/shell scripts, PDFs, markdown, screenshots, diagrams, images, and videos — all from a single folder. Claude’s vision capabilities pull concepts and relationships out of visual material too.
-
App + DB + infrastructure in one graph
Application code, database schemas, and infrastructure definitions land in the same graph. You can trace which functions read which tables and run on which containers in a single view.
-
Persistent graph across sessions
Results are saved to
graph.jsonso you can query across sessions without rebuilding. SHA256 hashing reprocesses only the files that changed. -
Multiple export formats
HTML interactive visualization, Obsidian vault, Wikipedia-style articles, GraphML, Neo4j Cypher, and SVG — formats that drop into other tools without conversion.
-
Auto-sync
Watch mode and git hook integration keep the graph current as code or docs evolve, no manual rebuild step required.
-
Edge provenance
Every edge is tagged
EXTRACTED,INFERRED, orAMBIGUOUS, making the line between explicit fact and model inference visible for review. -
MCP server mode
Pass
--mcpto expose the graph as a tool to other agents or clients — pushes the skill from solo use into multi-agent setups.
Output files
| File | Description |
|---|---|
graph.html | Interactive visualization — click nodes and edges to explore |
GRAPH_REPORT.md | Highlights and key findings as markdown |
graph.json | Full queryable graph data |
Notes
- PyPI package is temporarily
graphifyy— the proper name is being reclaimed, so the package has an extray. The slash command stays/graphify. - Python 3.10+ required —
graphify installprovisions the skill on your system. - Edge provenance tags — areas with many
INFERREDorAMBIGUOUSedges are worth reviewing manually before relying on them. - MIT licensed.
Frequently Asked Questions
What is Graphify?
An AI coding assistant skill that turns any folder of code, SQL schemas, R scripts, shell scripts, docs, papers, images, or videos into a queryable knowledge graph. The headline use case is putting app code, database schemas, and infrastructure in one graph.
Where does it run?
Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more. Requires Python 3.10+.
How do I install it?
`uv tool install graphifyy && graphify install` — pipx and pip work the same way. Note: the PyPI package is temporarily named `graphifyy` while the proper name is being reclaimed.
How do I invoke it?
Run `/graphify .` to build a graph for the current folder. It outputs `graph.html` (interactive visualization), `GRAPH_REPORT.md` (highlights), and `graph.json` (full queryable graph data).
Can it run as an MCP server?
Yes — pass the `--mcp` flag to expose the graph to other agents or clients as a tool, beyond the standalone skill workflow.
What's the license?
MIT licensed.