Чек-лист

Graphify: чек-лист установки и работы

Graphify (safishamsi/graphify) — граф знаний / карта проекта для AI-агентов: Claude Code, Codex, OpenCode, Cursor, Gemini CLI и др. Агент перестаёт «лазить по 10 файлам» — сохраняет все в одном месте

Содержание4 глав
  1. 01Установка и построение графа
  2. 02Безопасность и команды Graphify
  3. 03Graph Report и когда использовать Graphify
  4. 04Итог: Graphify как второй мозг агента

Graphify (safishamsi/graphify) — граф знаний / карта проекта для AI-агентов: Claude Code, Codex, OpenCode, Cursor, Gemini CLI и др. Агент перестаёт «лазить по 10 файлам» — ходит по карте связей. Экономит до 70% токенов (на больших репо — до 70×) и повышает точность. Работает и с кодом, и с контентом/документами. От Y Combinator, 60+ тыс. звёзд на GitHub за недели; развивает идею LLM-Wiki (граф знаний в Obsidian).

Без графа — дорого
Агент грузит файлы подряд: glob сканит всё → grep ищет по словам → читает не тот файл → перечитывает. Дорого и неточно.
С графом — точно
Граф строится один раз ДО сессии. Агент сначала находит нужный кусок, дальше идёт по связям. Пример: 123 000 → 1 700 токенов на запрос.
Выше промта
Даже CLAUDE.md / AGENTS.md не спасает от лишних кнопок. Граф обходит Obsidian / LLM-Wiki — контекст становится выше промта.

Установка и построение графа

01
Установить (2 команды)
Выполни в терминале. Пакет на PyPI — graphifyy (двойная «y»!)
02
Построить граф знаний
Запусти /graphify (в Codex — $graphify) — строит граф текущей папки. Своя папка: /graphify ./path. Только изменённые файлы: /graphify ./path --update. Глубже: --mode deep.
pip install graphifyy
graphify install
pipx install graphifyy

Безопасность и команды Graphify

🔒 Не слить секреты
Ключи, .env, секреты не должны попасть ни в граф, ни в модель.
01
Создай .graphifyignore
В корне проекта — синтаксис как у .gitignore, поддерживает !-негейт
02
.gitignore учитывается автоматически
Если есть оба файла — приоритет у .graphifyignore
03
Проверь вручную
Убедись, что секреты исключены до построения графа
/graphify query "…"Главная: связи и вопросы по графу
/graphify explain "X"Объяснить узел и его окружение
/graphify path "A" "B"Путь между двумя узлами
graphify hook installPost-commit hook: граф пересобирается после каждого коммита
Совет
Не учи всё наизусть: агент сам знает про Graphify и читает доку — просто ставь задачу.

Graph Report и когда использовать Graphify

Graph Notes
На чём держится проект
Главный узел. У автора это YouTube-канал.
Surprise Connections
Неожиданные связи
Которые сам бы не нашёл — инсайты архитектуры.
Suggested Questions
Вопросы к архитектуре
Вскрывают косяки в архитектуре проекта.
✅ Когда использовать
Репозиторий >100 файлов. Полиглот-monorepo. Онбординг новых участников. Не только код — документы, контент. Большие проекты на тысячи файлов (пример: SaaS Uleap AI).
❌ Когда не нужен
Мелкий репо (20–30 файлов), которым ты и так управляешь. Если уже используешь Obsidian Wiki для небольшой базы. Граф не нужен — это работа ради работы.

Принцип: Graphify — про большие системы, где контекст важнее ручного промта.

Итог: Graphify как второй мозг агента

Graphify — граф знаний, который превращает хаос из тысяч файлов в чёткую карту связей. Агент перестаёт блуждать — он знает, куда идти.

Построить граф
Все файлы
5 мин — часы
Защитить секреты
Добавить .graphify-ignore
до построения графа
Установить
2 команды
локально
Работать с картой
query, hook install, отчёт
команды Graphify