Настройка graphify для превращения кода в knowledge graph
Гайд по установке и использованию graphify — инструмента, который превращает любой codebase, включая документы, SQL-схемы, конфиги и PDF, в запросный knowledge graph с помощью локального AST-парсинга. Интеграция с Claude Code, Cursor, Codex и Gemini CLI.
Требования
- Node.js версии 18 или новее
- npm или yarn
- Доступ к терминалу
- Базовые знания Git
Установка graphify
Установите graphify глобально через npm, чтобы использовать его как CLI-инструмент. Это позволит запускать команды из любой директории.
npm install -g @graphify/cliИнициализация проекта
Создайте директорию для проекта и инициализируйте в ней graphify. Это создаст необходимую структуру для построения knowledge graph.
mkdir my-graphify-project && cd my-graphify-project
graphify initПодключение codebase
Подключите ваш codebase, указав путь к корневой директории проекта. Graphify проведёт локальный AST-парсинг всех поддерживаемых файлов.
graphify index --path /путь/к/вашему/кодуДобавление SQL-схем и конфигов
Graphify поддерживает индексацию SQL-схем и конфигурационных файлов. Укажите директории с этими файлами для полного охвата.
graphify index --sql /путь/к/sql/файлам --config /путь/к/конфигамИндексация PDF-документов
Для добавления PDF-документов в knowledge graph используйте флаг --pdf. Graphify извлечёт текст и структуру документа.
graphify index --pdf /путь/к/документу.pdfЗапуск локального сервера запросов
Запустите локальный сервер, чтобы выполнять запросы к knowledge graph. Graphify не использует векторное хранилище — все запросы обрабатываются детерминированно.
graphify serve --port 8080Выполнение запросов к graph
Отправляйте запросы к knowledge graph через API или встроенный CLI-интерфейс. Каждая связь (edge) сопровождается пояснением, почему она существует.
graphify query "Найди все функции, вызывающие метод X"Интеграция с Claude Code
Установите graphify как навык (/skill) для Claude Code, чтобы агент мог запрашивать knowledge graph прямо во время анализа кода. Используйте официальную документацию для настройки.
graphify install --claude-codeИнтеграция с Cursor, Codex и Gemini CLI
Аналогичная установка доступна для Cursor, Codex и Gemini CLI. Каждая интеграция позволяет агенту выполнять запросы к knowledge graph в контексте разработки.
graphify install --cursor
graphify install --codex
graphify install --gemini-cliЭкспорт knowledge graph
Экспортируйте knowledge graph в формате JSON или GraphQL для использования в сторонних системах. Все узлы и связи сохранят свои пояснения.
graphify export --format json --output graph.jsonНастройка graphify для превращения кода в knowledge graph
Гайд по установке и использованию graphify — инструмента, который превращает любой codebase, включая документы, SQL-схемы, конфиги и PDF, в запросный knowledge graph с помощью локального AST-парсинга. Интеграция с Claude Code, Cursor, Codex и Gemini CLI.
Предварительные требования
- Node.js версии 18 или новее
- npm или yarn
- Доступ к терминалу
- Базовые знания Git
Шаг 1: Установка graphify
Установите graphify глобально через npm, чтобы использовать его как CLI-инструмент. Это позволит запускать команды из любой директории.
npm install -g @graphify/cli
Шаг 2: Инициализация проекта
Создайте директорию для проекта и инициализируйте в ней graphify. Это создаст необходимую структуру для построения knowledge graph.
mkdir my-graphify-project && cd my-graphify-project
graphify init
Шаг 3: Подключение codebase
Подключите ваш codebase, указав путь к корневой директории проекта. Graphify проведёт локальный AST-парсинг всех поддерживаемых файлов.
graphify index --path /путь/к/вашему/коду
Шаг 4: Добавление SQL-схем и конфигов
Graphify поддерживает индексацию SQL-схем и конфигурационных файлов. Укажите директории с этими файлами для полного охвата.
graphify index --sql /путь/к/sql/файлам --config /путь/к/конфигам
Шаг 5: Индексация PDF-документов
Для добавления PDF-документов в knowledge graph используйте флаг --pdf. Graphify извлечёт текст и структуру документа.
graphify index --pdf /путь/к/документу.pdf
Шаг 6: Запуск локального сервера запросов
Запустите локальный сервер, чтобы выполнять запросы к knowledge graph. Graphify не использует векторное хранилище — все запросы обрабатываются детерминированно.
graphify serve --port 8080
Шаг 7: Выполнение запросов к graph
Отправляйте запросы к knowledge graph через API или встроенный CLI-интерфейс. Каждая связь (edge) сопровождается пояснением, почему она существует.
graphify query "Найди все функции, вызывающие метод X"
Шаг 8: Интеграция с Claude Code
Установите graphify как навык (/skill) для Claude Code, чтобы агент мог запрашивать knowledge graph прямо во время анализа кода. Используйте официальную документацию для настройки.
graphify install --claude-code
Шаг 9: Интеграция с Cursor, Codex и Gemini CLI
Аналогичная установка доступна для Cursor, Codex и Gemini CLI. Каждая интеграция позволяет агенту выполнять запросы к knowledge graph в контексте разработки.
graphify install --cursor
graphify install --codex
graphify install --gemini-cli
Шаг 10: Экспорт knowledge graph
Экспортируйте knowledge graph в формате JSON или GraphQL для использования в сторонних системах. Все узлы и связи сохранят свои пояснения.
graphify export --format json --output graph.json