Graphify:给 Claude Code 用的代码库知识图谱
Graphify 把整个仓库——代码、文档、SQL schema、配置和 PDF——变成一张可直接查询的知识图谱。tree-sitter 本地解析,每条边都带标注,不是向量库。
一句话看懂 Graphify
- 它是第三方开源项目(Graphify-Labs/graphify,Apache-2.0,Python 编写),不是 Anthropic 官方产品。它提供一个 `/graphify` skill,供 Claude Code、Cursor、Codex、Gemini CLI 等助手使用。
- 代码用 tree-sitter 解析成 AST,全程本地、确定性,不调模型。每条边都标成 `EXTRACTED`(源码里写明)或 `INFERRED`(由 Graphify 推断)。
- 它是可以遍历的图,不是向量索引:没有 embedding,也没有向量库。`/graphify query` 只返回回答所需的节点和边。
- 三条命令上手:`uv tool install graphifyy`、`graphify install`,然后在仓库里 `/graphify .`。产物落在 `graphify-out/`。
Graphify-Labs/graphify — repository and README
来源github.com2026-11-15
Graphify Quickstart
来源docs.graphify.com2026-11-15
GitHub REST API — repos/Graphify-Labs/graphify
来源api.github.com2026-11-15
本页的命令、参数与文件名均来自上面三个来源,读取时间为 2026-11-15。命令与路径故意不翻译——翻译过的命令是跑不起来的。
核查日期 2026-11-15。仓库默认分支为 v8,最后一次 push 是 2026-11-14;star 与 fork 数每天都在变,引用前请重新读一次 API。
Graphify 到底是什么
项目自己的描述:把任意代码库连同它的文档、SQL schema、配置和 PDF,转成一张可查询的知识图谱——为 Claude Code、Cursor、Codex 和 Gemini CLI 提供的 `/graphify` skill,本地确定性 AST 解析,每条边都有解释,且不含向量库。
实际用过一遍是这样的:先装一个 CLI(`graphify`)和一个 skill,然后在助手里输入 `/graphify`。助手完成 detection、extraction、clustering,把图写进 `graphify-out/`,之后答题靠遍历这张图,而不是 grep 整个目录树。
- 许可证
- Apache-2.0
- 语言
- Python(包名 graphifyy)
- star / fork
- 147,983 / 14,194 —— 2026-11-15 快照
- 状态
- 第三方;默认分支 v8;最近 push 2026-11-14
不是 Anthropic 官方项目
Graphify 由 Graphify-Labs 组织以 Apache-2.0 发布(GitHub API 显示 is_verified: false)。Anthropic 不维护它,Claude Code 也不自带它:需要你自己安装,它跑在你自己的文件上。
图是怎么建出来的
代码先用 tree-sitter 解析成 AST。这一步是确定性的、在你机器上跑:不调 LLM,也不往外传任何东西。跨文件关系(calls、imports、inherits、mixes_in)由 AST 得出,覆盖约 40 种语言;`# NOTE:` / `# WHY:` 注释以及 ADR、RFC 引用同样会变成节点。
文档、PDF、图片和视频会走第二遍语义处理,用的是你助手的模型,或你配置的 API key。消耗 token 的是这一段,代码图本身不消耗。
每条边都有解释
每条连接都带标记:源码里写明的关系标 `EXTRACTED`,由 Graphify 解析出来的标 `INFERRED`。你能分清哪些是从代码里读到的,哪些是推出来的。
不是向量索引
没有 embedding,也没有向量库。产物是一张真正的图——节点、边、社区、god node——用 `query`、`path`、`explain` 去遍历它。
给 Claude Code 安装 Graphify
三条命令。`graphify install` 默认目标就是 Claude Code,换别的助手只差一个参数。
安装 CLI
包名是 `graphifyy`——两个 y。它装出 `graphify` 和 `graphify-mcp` 两个命令。需要 Python 3.10 或更高版本,三个包管理器任选其一。
# Python 3.10 or lateruv tool install graphifyy# or: pipx install graphifyy# or: pip install graphifyy注意拼写:要装的是 `graphifyy`,敲的是 `graphify` 和 `graphify-mcp`。
注册 skill
不带参数时 `graphify install` 针对 Claude Code:把 skill 复制到 `~/.claude/skills/graphify/SKILL.md`,并注册进 `~/.claude/CLAUDE.md`。换其它助手就加 `--platform`。
graphify install# Claude Code (default): ~/.claude/skills/graphify/SKILL.md# registered in ~/.claude/CLAUDE.md# another assistant: graphify install --platform codex例如 `graphify install --platform codex`。如果之后 `/graphify` 仍不被识别,重启助手,或确认 `~/.claude/skills/graphify/SKILL.md` 是否存在。
在仓库里运行
在助手里打开仓库,运行 `/graphify .`。agent 会做 detect、extract、cluster,然后汇总报告;代码在本地解析,文档与论文走 agent 自己的模型。
/graphify .接着提问:`/graphify query "how does authentication reach the database"` 只返回回答所需的节点与边,并按 token 预算裁剪。
开始之前
- 1Python 3.10 或更高版本。
- 2uv、pipx 或 pip——用你平时装 CLI 的那个就行。
- 3一个 `graphify install` 支持的编码助手(默认 Claude Code),以及一个要索引的仓库——本地路径,或给 `/graphify <url>` 用的公开 GitHub 地址。
真正会用到的命令
以上命令照抄文档的 quickstart 与命令表。以 `/` 开头的是在助手里输入,其余在 shell 里跑。
| 命令 | 作用 |
|---|---|
/graphify query "…" | 提一个问题;只返回回答所需的节点和边,并裁剪到 token 预算内。 |
/graphify path "AuthModule" "Database" | 显示两个节点之间的最短路径——这里是 AuthModule 到 Database。 |
/graphify explain "SessionStore" | 解释单个节点:它是什么、连着什么、为什么这么连。 |
/graphify . --update | 在已有图上增量刷新,不必从头重建。 |
/graphify . --mode deep | 走更深的抽取模式——更慢,但解析出的关系更多。 |
/graphify . --wiki | 额外生成一份 wiki 风格的图谱说明。 |
/graphify https://github.com/<owner>/<repo> | 直接指向一个公开仓库 URL,而不是本地路径。 |
graphify hook install | 装 git hooks(post-commit、post-checkout、post-merge、post-rewrite,外加 merge driver),让图跟着仓库走;`graphify hook status` 应把四项都列为 installed。 |
graphify god-nodes --top 5 | 打印连接最多的节点——快速确认图已生成、结构正常。 |
graphify extract . --code-only | 只跑代码抽取,跳过文档与多媒体的 LLM 步骤。 |
graphify uninstall | 卸载 skill 及其注册项。 |
如果命令找不到图,就到含 `graphify-out/` 的目录里运行,或显式传 `--graph graphify-out/graph.json`。
graphify-out/ 里有什么
文档给出的目录结构,原文照抄:
graphify-out/├── graph.json├── graph.html├── GRAPH_REPORT.md├── manifest.json└── cache/- 1`graph.json`——完整的图,别的工具要读数据就读它。
- 2`graph.html`——浏览器视图:点节点、筛选、搜索。
- 3`GRAPH_REPORT.md`——要点、意外发现的连接,以及建议提问的问题。
- 4`manifest.json`——记录这次索引了哪些内容的清单。
- 5`cache/`——本地工作数据,建议加进 `.gitignore` 而不要提交。
该提交哪些
文档建议提交 `graph.json` 与 `GRAPH_REPORT.md`,并把 `cache/` 写进 `.gitignore`。README 的简版说你会得到“三个文件”(`graph.html`、`GRAPH_REPORT.md`、`graph.json`),quickstart 则列出五项。两者说的是同一个目录,只是详略不同。
持久化的图里还会记录 `graph.schema_version` 与 `graph.graphify_version`。升级 CLI 后要检查这两项:旧版图可能需要重建。
让图保持新鲜
图的 freshness 只等于上一次构建,所以要接进 git:
graphify hook installgraphify hook status# → 4 hooks installed, merge driver: registered`graphify hook install` 会接上 post-commit、post-checkout、post-merge、post-rewrite 四个钩子以及 merge driver。之后 `graphify hook status` 应显示四个钩子 installed,并显示 “merge driver: registered”。
文档或图片变了,就重跑 `/graphify . --update`,不必整图重建。
什么场景合适,它不做什么
Graphify 是代码地图工具。当“仓库的形状”比“某个文件的原文”更重要时,它才值得装。
适合的场景
- 1接手陌生代码库,想在看文件之前先看清模块、god node 和社区结构。
- 2问题本身是关系问题——这个怎么走到那个、谁调用了它——这类问题 grep 答不好。
- 3你希望把地图提交进仓库,让团队或 agent 反复读取,而不用每次重付构建成本。
需要知道的限制
- 1免费且完全本地的部分只覆盖代码。文档、PDF、图片和视频的语义处理要走模型,这部分要么耗 token,要么需要 API key。
- 2`INFERRED` 边是 Graphify 的解析结果,不是源码里的事实。信任某条连接之前先看标记。
- 3图是快照。不装 hooks 也不用 `--update`,它就会像 README 一样过期。
- 4它是个年轻的第三方项目:它的价值论证来自自己的 README,而不是独立评测。
项目在 README 里给出自己的 benchmark 表——例如 n=300 时 LOCOMO recall@10 为 0.497。那是维护者自己的测量,不是独立结论,请当作一条待验证的说法,在自己的仓库上复核。
DeepSeek Harness 侧的 Graphify
DeepSeek Harness 的插件目录里还有一个第三方的原生插件。它属于社区作品,与 Graphify-Labs 仓库没有隶属关系。
查看插件详情