---
name: graphify-install
description: Graphify (knowledge-graph skill для AI-ассистентов) установлен на MacBook; пакет/команды/3 токен-гарда/эвристика размера/безопасная установка
metadata: 
  node_type: memory
  type: reference
  originSessionId: bf9e57eb-3bce-4222-8ef0-8c7c97546504
---

**Graphify** — open-source скилл «папка кода/доков → запрашиваемый граф знаний» (github safishamsi/graphify, MIT). Установлен на MacBook (2026-06-16).

- **Пакет на PyPI — `graphifyy` (ДВЕ `y`), команда — `graphify` (одна).** `pip install graphify` ставит мусор. Ставить: `uv tool install graphifyy` (или `pipx install graphifyy`). Версия 0.8.40, бинари `~/.local/bin/graphify` + `graphify-mcp`.
- Скилл зарегистрирован глобально: `~/.claude/skills/graphify/SKILL.md` (+ `references/`), вызов `/graphify .` или авто-триггер по вопросам о кодовой базе. Ставил через `graphify install --platform claude` — **безопасный путь**: только скилл + строчка в `~/.claude/CLAUDE.md` (приписана в самый конец, за финальным `---`), БЕЗ PreToolUse-хука. Проверено: graphify-хука в `~/.claude/settings.json` нет.
- Извлечение кода **локальное, 0 токенов** (tree-sitter AST, 36 языков). LLM нужен только для семантики/именования кластеров (`--mode deep`, `label`). Бэкенды: gemini/kimi/claude/openai/deepseek/ollama (по выставленному API-ключу; `OPENAI_BASE_URL` для self-hosted).
- Проверено реально end-to-end: build (`graphify update .`) → graph.json/html/report, + `query`/`explain`/`path` отрабатывают.

**3 ГАРДА (от лид-магнита graph-pilot, мной проверены — применять при работе с graphify):**
1. Пакет `graphifyy` две-y (см. выше).
2. **`--mode deep` ЖЖЁТ ТОКЕНЫ** (гонит доки через LLM). Базовый AST бесплатен. Запускать `graphify extract . --mode deep` только если реально много доков/PDF И юзер явно попросил «глубокий разбор». Иначе — обычный AST.
3. **`graphify claude install` вшивает PreToolUse-хук**, который на части сборок Claude Code слетает и блокирует чтение файлов. НЕ запускать вслепую. Нужен авто-апдейт → безопасный `graphify hook install` (post-commit git-хук, 0 токенов). Откат сломанного хука: убрать блок `hooks` с `graphify` из `~/.claude/settings.json` → перезапуск.

**Эвристика «нужен ли граф»:** <100 файлов — нет (грэп и так дёшев); 100–500 — умеренно (~6–15×); >500 — окупается (30×+). «71×» = крайний случай монорепо. Экономию можно измерить: `graphify benchmark`.

**Реальный синтаксис 0.8.40** (у блогера graph-pilot он ПРОТУХ — `graphify .`, `--update`, `--wiki`, `--obsidian`, `--svg`, `--graphml`, `--resolution`, `--exclude-hubs` НЕ существуют/неверны; graph-pilot как есть НЕ ставить):
- build headless: `graphify extract <path>` (AST+семантика) · code-only refresh: `graphify update <path>` (0 токенов, `--force` тут же)
- `graphify query "<вопрос>"` / `path "A" "B"` / `explain "X"` / `affected "X"` — дёшево, читают граф
- `cluster-only <path>`, `label <path>`, `tree`, `export callflow-html`, `global add/list`, `clone`, `add <url>`, `watch`, `benchmark`, `hook install`
