PlugWiki

graphify: Turn a Codebase into a Knowledge Graph for Claude

Maps your code, docs and papers into a knowledge graph your assistant can query, so it answers architecture questions without reading every file.

Installs
12.1K
on skills.sh
Stars
140.5K
on GitHub
Files
60+
besides SKILL.md
Updated
Nov 2026
last repo commit

graphify makes your coding assistant map a project into a knowledge graph, then answer questions from that graph instead of searching file by file. You run the /graphify command on a folder and it builds a clickable graph and a short report of the main ideas in your project. Code is read on your machine, but docs, PDFs and images are sent to your assistant's model. The skill is only the front door to a Python tool, so the install box above installs the graphifyy package first.

Good for

  • Developers who join big codebases and want a map before they read any code
  • Claude Code, Codex or Cursor users who want the assistant to check a graph before it searches files
  • Researchers who keep papers, notes and screenshots in one folder and want to see how they connect
  • Teams that review many pull requests and want to see what each change touches

Install graphify

Claude Code

  1. 1

    Copy this prompt.

    Install the graphify skill in Claude Code. Run this command:
    
    uv tool install graphifyy
    graphify install
    
    Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Python 3.10 or newer, uv (or pipx).

The PyPI package is graphifyy, with two y's; the command it installs is graphify. graphify install registers the skill and writes Claude instructions and PreToolUse hooks that point Claude Code at the graph. Then open your project and type /graphify . to build the graph. Update with uv tool upgrade graphifyy, then run graphify install --platform claude again.

From the project README. Source.

What's in the skill

When it loads

Use for any question about a codebase, its architecture, file relationships, or project content — especially when graphify-out/ exists, where the question should be treated as a graphify query first. Turns any input (code, docs, papers, images, videos) into a persistent knowledge graph with god nodes, community detection, and query/path/explain tools.

Sections in SKILL.md

  1. Usage
  2. What graphify is for
  3. What You Must Do When Invoked
  4. Step 0 - GitHub repos and multi-path merge (only if a URL or several paths)
  5. Step 1 - Ensure graphify is installed
  6. Step 2 - Detect files
  7. Step 2.5 - Video and audio (only if video files detected)
  8. Step 3 - Extract entities and relationships
  9. Step 4 - Build graph, cluster, analyze, generate outputs
  10. Step 4.5 - Graph health check (read-only integrity gate)
  11. Step 5 - Label communities
  12. Step 6 - Generate Obsidian vault (opt-in) + HTML
  13. Steps 6b-8 - Wiki, Neo4j, FalkorDB, SVG, GraphML, MCP, benchmark (only on their flags)
  14. Step 9 - Save manifest, update cost tracker, clean up, and report
  15. Interpreter guard for subcommands
  16. For --update and --cluster-only

Key facts

License
Apache-2.0
Installs on skills.sh
12,102 (Nov 1, 2026)
Last commit
Nov 1, 2026

What it includes

  • Maps the whole folder into a knowledge graph and opens a report

    Runs the full pipeline on the current folder: finds files, parses code locally, has the assistant read docs, papers and images, clusters the result into communities and writes graph.html, GRAPH_REPORT.md and graph.json into graphify-out/. It then shows the key concepts and offers a question to explore.

    Try: “/graphify .”

    Runs code · /graphify .

  • Clones a GitHub repo (or several) and builds one graph

    Give it one or more GitHub URLs, optionally with --branch, and it clones them and builds a graph; several repos are merged into one cross-repo graph.

    Try: “/graphify https://github.com/<owner>/<repo>”

    Runs code · /graphify <github-url>

  • Answers a question from the graph instead of reading files

    Searches the graph for nodes matching your question and returns the connected piece of the graph, broad (default) or as one traced path with --dfs. --budget caps the answer size in tokens. Answers cite source locations.

    Try: “/graphify query "what connects auth to the database?"”

    Read · /graphify query

  • Shows the shortest chain of links between two things

    Finds how two names connect, hop by hop, and reports the path's overall confidence (its weakest link).

    Try: “/graphify path "UserService" "DatabasePool"”

    Read · /graphify path

  • Explains one function, class or concept and what it connects to

    Prints where a node is defined, its community, how many links it has and each connection tagged EXTRACTED or INFERRED.

    Try: “/graphify explain "RateLimiter"”

    Read · /graphify explain

  • Re-reads only the files that changed since the last build

    Incremental rebuild: re-extracts new or changed files and keeps the rest from cache. Code changes need no model calls.

    Try: “/graphify ./docs --update”

    Write · --update / graphify update

  • Regroups the existing graph without re-reading files

    Reruns community detection on the graph you already have and rewrites the report; --resolution makes groups finer and --exclude-hubs hides utility hubs from the top concepts.

    Try: “/graphify . --cluster-only --resolution 1.5”

    Write · --cluster-only

  • More thorough extraction with more inferred links

    Tells the extraction subagents to dig harder and add more INFERRED edges, at higher token cost.

    Try: “/graphify <path> --mode deep”

    Write · --mode deep

  • Fetches a web page, paper or video and adds it to the graph

    Downloads the URL into ./raw (transcribing videos), then updates the graph. --author and --contributor tag who wrote or added it.

    Try: “/graphify add https://arxiv.org/abs/1706.03762”

    Write · /graphify add <url>

  • Rebuilds the code graph every time you save a file

    Watches the folder and rebuilds the code part of the graph on changes with no model calls. Needs the watch extra.

    Try: “graphify watch .”

    Write · --watch / graphify watch

  • Writes the graph as an Obsidian vault, wiki, SVG, GraphML or database import

    Optional outputs on their flags: an Obsidian vault, a Markdown wiki with one article per community, graph.svg, GraphML for Gephi or yEd, and Cypher files or a direct push to Neo4j or FalkorDB.

    Try: “/graphify . --wiki”

    Write · Exports (--obsidian, --wiki, --svg, --graphml, --neo4j, --falkordb)

  • Draws an architecture and call-flow page

    Writes a Mermaid-based HTML page of the architecture and call flow; with the git hook installed it regenerates on every commit.

    Write · graphify export callflow-html

From the official docs

Permissions

Medium risk

graphify runs a Python package that reads your repo and writes hooks into your assistant's config. Code stays local; docs, PDFs and images go to your assistant's model.

What it can do

Watch out for

  • Re-running the Claude install can delete CLAUDE.md notes

    An open issue reports that it removes everything below the graphify section when no later top-level heading exists. Back up CLAUDE.md first. github.com

  • skills.sh: Socket warn

    One low anomaly alert on skill.md (Oct 16, 2026). skills.sh

  • skills.sh: Gen Agent Trust Hub pass

    Rated safe (Oct 16, 2026). Notes subprocess and git calls, network fetches only for URLs you add, git hooks and skill files written only when you run the install commands. skills.sh

  • skills.sh: Snyk pass

    Risk level low, no issues detected (Oct 16, 2026). skills.sh

Security advisories

Technical details
Turning on read-onlyThe optional graphify-mcp server exposes 10 read-only tools over a graph you already built.
Talks toYour assistant's model: docs, PDFs and images go there for the semantic pass. Code files stay on your machine.. Headless graphify extract uses whichever API key is set (Gemini, Kimi, Claude, OpenAI, DeepSeek and others). GRAPHIFY_BACKEND=none turns all model calls off.. URLs you add with /graphify add (arXiv, YouTube, X). No telemetry, per the README
Scopes
  • Installs and runs the graphifyy Python package on your machine

  • Reads every file in the folder you point it at, and skips secret-prone files such as .env, .pem, id_rsa, .ssh and .aws

  • Writes graph.json, an HTML graph and a report to graphify-out/ in your project

  • graphify install writes Claude instructions in CLAUDE.md and PreToolUse hooks

  • graphify hook install adds git post-commit, post-checkout and post-merge hooks (only if you run it)

What people say

People are curious about the idea and unconvinced it beats plain search on strong models.

What people like

  • A user comparing it with Ix for their project picked graphify.
  • Other tools build on its output, and Graphify C# says its JSON can be used directly by graphify.

Common complaints

  • Hacker News commenters doubt code-graph tools beat a plain agent with ripgrep on current models.
  • The benchmark numbers in the vendor's discussion came from a Graphify Labs collaborator, so they are not independent.
  • Copilot CLI users report it picks up API keys from the environment instead of using their Copilot plan.

In their words

Examples

  • Build a graph of the current project

    /graphify .

    Source
  • Ask how two parts of the code connect

    /graphify query "what connects auth to the database?"

    Source
  • Trace the shortest path between two classes

    /graphify path "UserService" "DatabasePool"

    Source
  • Ask Claude Code about a flow once the graph exists

    Use Graphify to explain the authentication flow. Cite the source files and distinguish explicit relationships from inferred ones.

    Source
  • Ask a plain question that the hooks route to the graph

    where do we retry failed uploads?

    Source
  • Add a research paper to the graph

    /graphify add https://arxiv.org/abs/1706.03762

    Source

Questions

How do I install graphify?

Install the Python package graphifyy (double y) with uv tool install graphifyy or pipx install graphifyy, then run graphify install so it registers the skill with your assistant. Open your project and type /graphify .. It needs Python 3.10 or newer. Other assistants use their own flag, such as graphify install --platform codex; the install box has each one.

Does graphify work in Claude.ai, Codex and Cursor?

Claude Code, Codex and Cursor are documented. Codex runs it as $graphify and needs multi_agent = true in its config for parallel work, and Cursor gets a short rule file rather than the full skill. No source covers the claude.ai chat site or the Claude desktop chat, so do not count on it there.

Is graphify safe?

Mostly. On skills.sh, Snyk and Gen Agent Trust Hub pass it and Socket warns with one low finding. One advisory, GHSA-pcc4-rvhr-2pr8, is fixed in 0.9.70; the repo rates it high and the GitHub Advisory Database rates it moderate. The permissions section above lists what it reads, writes and sends.

Can graphify delete my CLAUDE.md notes?

It can. An open issue reports that re-running the Claude install deletes everything in CLAUDE.md below the graphify section when no later top-level heading exists, with no warning. Back up CLAUDE.md before you re-run the install, or put your own notes under a top-level heading after the graphify block.

Does graphify send my code anywhere?

Code files are read on your machine and nothing leaves it for those, and the README says there is no telemetry. Docs, PDFs and images go to your assistant's model, or to Gemini if a Gemini or Google key is set. Setting GRAPHIFY_BACKEND=none turns all model calls off.

Is graphify free, and does it need an API key?

Yes, it is free and open source under Apache-2.0, and the skill needs no API key. It uses your assistant's own model for docs and images, so reading many papers or images can take minutes and tens of thousands of tokens. Code-only runs cost nothing in model use. Graphify Cloud is a separate hosted product.

What is the Karpathy connection?

Graphify's first PyPI release opened with Andrej Karpathy's /raw folder of papers, tweets and notes, which gets hard to see into over time, and called graphify the answer to that problem. That is the link the sources show.

Does graphify have an MCP server?

Yes, as an optional extra. Install the package with its mcp extra, build a graph, then point your client at graphify-mcp and the path to graph.json. It gives your assistant 10 read-only tools and runs on your machine unless you start it in HTTP mode.

graphify vs Ix or Graphify Cloud?

Ix is another open-source command line tool that maps a codebase into a persistent graph for agents, and it was pitched on Hacker News as the alternative to graphify's inferred links. Graphify Cloud is the same team's hosted version, which keeps an always-on graph across repos instead of building graphify-out locally.

Does graphify actually save tokens?

The vendor reports 82% versus 70.8% key-fact coverage over a grep and read baseline on ERPNext. Hacker News commenters are skeptical and say plain ripgrep did as well in their informal tests. The skill itself says a plain grep is faster for a one-off lookup.

Information

updated Nov 2, 2026

Folder
graphify

graphify-labs/graphifyskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 25
  1. graphify README · github.com
  2. Graphify for Claude Code · docs.graphify.com
  3. Graphify integrations · docs.graphify.com
  4. graphify skill.md · github.com
  5. Author profile · github.com
  6. License · github.com
  7. graphify on skills.sh · skills.sh
  8. Repository · github.com
  9. graphifyy on PyPI · pypi.org
  10. Graphify always-on setup · docs.graphify.com
  11. Graphify MCP server · docs.graphify.com
  12. docs.graphify.com · docs.graphify.com
  13. Socket · skills.sh
  14. Snyk · skills.sh
  15. Gen Agent Trust Hub · skills.sh
  16. Security advisory GHSA-pcc4-rvhr-2pr8 (repo, severity high) · github.com
  17. GitHub Advisory Database: GHSA-pcc4-rvhr-2pr8 (severity moderate) · github.com
  18. Re-running install deletes CLAUDE.md content · github.com
  19. graphifyy 0.1.1 · pypi.org
  20. Ix · github.com
  21. Ask HN: We got 100 stars · news.ycombinator.com
  22. Benchmarks discussion · github.com
  23. Show HN: Graphicle, a Rust port of Graphify · news.ycombinator.com
  24. Graphify C# · news.ycombinator.com
  25. Copilot CLI issue · github.com

Updated Nov 2, 2026.