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

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

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

врезка-пара: левый callout — метка `// Без графа — дорого`, текст «Агент грузит файлы подряд: glob сканит всё → grep ищет по словам → читает не тот файл → перечитывает. Дорого и неточно.»; правый callout — метка `// С графом — точно`, текст «Граф строится один раз ДО сессии. Агент сначала находит нужный кусок, дальше идёт по связям. Пример: 123 000 → 1 700 токенов на запрос.»

врезка `// Выше промта`: текст «Даже CLAUDE.md / AGENTS.md не спасает от лишних кнопок. Граф обходит Obsidian / LLM-Wiki — контекст становится выше промта.»

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

- 01 «Установить (2 команды)» — Выполни в терминале. Пакет на PyPI — graphifyy (двойная «y»!); другие graphify* — не он. Ошибка externally-managed (macOS) или PATH (Windows) → ставь через pipx install graphifyy. graphify install подключает скилл в Claude Code, Codex, OpenCode и др.
- 02 «Построить граф знаний» — Запусти /graphify (в Codex — $graphify) — строит граф текущей папки. Своя папка: /graphify ./path. Только изменённые файлы: /graphify ./path --update. Глубже: --mode deep. Посреди процесса агент остановится и спросит охват → выбери все файлы. Локально парсит 36 языков (tree-sitter) + аудио/видео (whisper); код-корпус — офлайн, без API-ключа. Доки/PDF/картинки разбираются через LLM-ассистента. Время: ~5 мин малый проект, до часов большой.

```
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 install → Post-commit hook: граф пересобирается после каждого коммита

врезка `// Совет`: текст «Не учи всё наизусть: агент сам знает про Graphify и читает доку — просто ставь задачу.»

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

карточка 1 — метка «Graph Notes» / значение «На чём держится проект» / капшен «Главный узел. У автора это YouTube-канал.»; карточка 2 — метка «Surprise Connections» / значение «Неожиданные связи» / капшен «Которые сам бы не нашёл — инсайты архитектуры.»; карточка 3 — метка «Suggested Questions» / значение «Вопросы к архитектуре» / капшен «Вскрывают косяки в архитектуре проекта.»

врезка-пара: левый callout — метка `// ✅ Когда использовать`, текст «Репозиторий >100 файлов. Полиглот-monorepo. Онбординг новых участников. Не только код — документы, контент. Большие проекты на тысячи файлов (пример: SaaS Uleap AI).»; правый callout — метка `// ❌ Когда не нужен`, текст «Мелкий репо (20–30 файлов), которым ты и так управляешь. Если уже используешь Obsidian Wiki для небольшой базы. Граф не нужен — это работа ради работы.»

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

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

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

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

---

Источник: https://localhost:3000/m/graphify-chek-list-ustanovki-i-raboty-a356