Graphify: граф знаний по кодовой базе для Claude Code
Graphify превращает репозиторий — код, документацию, SQL-схемы, конфиги и PDF — в граф знаний, к которому можно обращаться изнутри Claude Code. Локальный разбор через tree-sitter, каждое ребро помечено, векторного хранилища нет.
Graphify в двух словах
- Сторонний open-source проект (Graphify-Labs/graphify, Apache-2.0, написан на Python), а не продукт Anthropic. Даёт навык `/graphify` для Claude Code, Cursor, Codex, Gemini CLI и других ассистентов.
- Код разбирается tree-sitter в AST локально и детерминированно, без вызовов модели. Каждое ребро помечено: `EXTRACTED` (явно в исходнике) или `INFERRED` (выведено Graphify).
- Это граф, по которому ходят, а не векторный индекс: ни эмбеддингов, ни векторного хранилища. `/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. Число звёзд и форков меняется ежедневно, поэтому перед цитированием перечитайте API.
Что такое Graphify на самом деле
Описание самого проекта: превратить любую кодовую базу вместе с её документацией, SQL-схемами, конфигами и PDF в граф знаний, к которому можно обращаться — навык `/graphify` для Claude Code, Cursor, Codex и Gemini CLI, локальный детерминированный разбор AST, объяснение каждого ребра и никакого векторного хранилища.
На практике вы ставите CLI (`graphify`) и навык, а затем вводите `/graphify` внутри ассистента. Ассистент выполняет обнаружение, извлечение и кластеризацию, записывает граф в `graphify-out/`, и дальше отвечает на вопросы, обходя этот граф вместо grep по дереву.
- Лицензия
- Apache-2.0
- Язык
- Python (пакет graphifyy)
- Звёзды / форки
- 147,983 / 14,194 — снимок на 2026-11-15
- Состояние
- Сторонний проект; ветка по умолчанию v8; последний push 2026-11-14
Это не проект Anthropic
Graphify публикует организация Graphify-Labs (GitHub API сообщает is_verified: false) под Apache-2.0. Anthropic его не поддерживает, в Claude Code он не входит: вы ставите его сами, и он работает с вашими файлами.
Как строится граф
Код разбирается tree-sitter в AST. Этот проход детерминирован и идёт на вашей машине: без LLM, ничего не уходит наружу. Связи между файлами (calls, imports, inherits, mixes_in) берутся из AST примерно для 40 языков; комментарии `# NOTE:` / `# WHY:`, а также ссылки на ADR и RFC тоже становятся узлами.
Документация, PDF, изображения и видео проходят второй, семантический проход — через модель вашего ассистента или настроенный API-ключ. Именно эта часть тратит токены; сама карта кода — нет.
Каждое ребро объяснено
У каждой связи есть метка: `EXTRACTED`, если отношение явно в исходнике, и `INFERRED`, если Graphify его вывел. Видно, что прочитано из кода, а что додумано.
Это не векторный индекс
Ни эмбеддингов, ни векторного хранилища. На выходе настоящий граф — узлы, рёбра, сообщества, god nodes — и по нему ходят командами `query`, `path` и `explain`.
Установка Graphify для Claude Code
Три команды. Цель по умолчанию для `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`.
Зарегистрируйте навык
Без флагов `graphify install` нацелен на Claude Code: копирует навык в `~/.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 .`. Агент выполняет обнаружение, извлечение и кластеризацию, затем отчитывается; код разбирается локально, а документация и статьи идут через модель самого агента.
/graphify .Дальше задавайте вопросы: `/graphify query "how does authentication reach the database"` возвращает только нужные для ответа узлы и рёбра, обрезанные под бюджет токенов.
Перед началом
- 1Python 3.10 или новее.
- 2uv, pipx или pip — тот, которым вы уже ставите CLI.
- 3Ассистент, который поддерживает `graphify install` (по умолчанию Claude Code), и репозиторий для индексации — локальный или публичный GitHub URL для `/graphify <url>`.
Команды, которыми вы реально будете пользоваться
Дословно из quickstart и таблицы команд в документации. Команды с `/` вводятся в ассистенте, остальные — в оболочке.
| Команда | Что делает |
|---|---|
/graphify query "…" | Задаёт вопрос и возвращает только нужные для ответа узлы и рёбра, обрезанные под бюджет токенов. |
/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-хуки (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 | Удаляет навык и его регистрации. |
Если команда не находит граф, запустите её из каталога с `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: старый граф может требовать пересборки.
Как держать граф свежим
Граф актуален ровно на момент последней сборки, поэтому подключите его к 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 nodes и сообщества прежде, чем читать файлы.
- 2Вопрос касается отношений — как одно доходит до другого, кто это вызывает — а grep отвечает на такое плохо.
- 3Вы хотите закоммитить карту, чтобы команда или агент перечитывали её, не платя за пересборку.
Ограничения, о которых стоит знать
- 1Бесплатная и полностью локальная часть — это код. Документация, PDF, изображения и видео идут через модель на семантическом проходе, так что эти части стоят токенов или API-ключа.
- 2Рёбра `INFERRED` — это вывод Graphify, а не факт из исходника. Смотрите на метку, прежде чем доверять связи.
- 3Граф — снимок. Без хуков и `--update` он устаревает так же, как README.
- 4Это молодой сторонний проект: аргументы в его пользу идут из его собственного README, а не из независимой оценки.
Проект публикует в README собственную таблицу бенчмарков — например, LOCOMO recall@10 = 0.497 при n=300. Это измерения мейнтейнеров, а не независимый результат, поэтому относитесь к ним как к утверждению, которое стоит проверить на своём репозитории.
Graphify в DeepSeek Harness
В каталоге плагинов DeepSeek Harness есть и сторонний нативный плагин. Это работа сообщества, не связанная с репозиторием Graphify-Labs.
Открыть карточку плагина