Чек-лист

Этот Open-source УМЕНЬШАЕТ расход токенов в Claude и Codex на 70%

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

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

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

Ссылка на Graphify: https://github.com/safishamsi/graphify

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

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

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

Шаг 1. Установить (2 команды). Выполни в терминале:

pip install graphifyy
graphify install

Пакет на PyPI — graphifyy (двойная «y»!); другие graphify* — не он.

Ошибка externally-managed (macOS) или PATH (Windows) → ставь через:

pipx install graphifyy

graphify install подключает скилл в Claude Code, Codex, OpenCode и др.

Шаг 2. Построить граф знаний. Запусти /graphify (в Codex — $graphify) — строит граф текущей папки.

  • Своя папка: /graphify ./path
  • Только изменённые файлы: /graphify ./path --update
  • Глубже: --mode deep
Посреди процесса
Агент остановится и спросит охват → выбери все файлы.

Локально парсит 36 языков (tree-sitter) + аудио/видео (whisper); код-корпус — офлайн, без API-ключа. Доки/PDF/картинки разбираются через LLM-ассистента.

Время: ~5 мин малый проект, до часов большой.

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

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

Не учи всё наизусть: агент сам знает про 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, отчёт
/ материалы

Чек-лист