# Граф кода

> Подключите к нему агента — и он будет находить код по структуре: кто вызывает функцию, что она вызывает, где объявлен символ, — вместо grep и чтения файла за файлом.

Source: https://docs.neurosquad.ai/ru/plugins/code-graph

Чтобы ответить «что вызывает `processOrder`?», агент обычно запускает grep, открывает файл, снова
grep, открывает следующий — и тратит тысячи токенов на код, который ему не нужен. Плагин **Граф кода**
индексирует код воркспейса в граф знаний — функции, классы, методы, вызовы, импорты, маршруты — с
помощью [codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp), открытого движка от
DeusData. Подключённый агент спрашивает граф и получает ответ одним вызовом.

## Как пользоваться

1. В меню добавления карточки выберите **Плагины**, откройте **Граф кода** на вкладке **Плагины** и
нажмите **Добавить на канвас**.
2. Нажмите **Скачать** на карточке. NeuroSquad скачает официальную сборку codebase-memory-mcp с
GitHub (около 40 МБ, около 300 МБ после распаковки) и сверит её с контрольной суммой, зашитой в
приложение, — несовпадающий файл удаляется. Это нужно один раз.
3. Нажмите **Построить граф**. Большинству проектов хватает секунд, очень большому — нескольких
минут.
4. Проведите [стрелку](https://docs.neurosquad.ai/ru/canvas/arrows) от агента к карточке.

Теперь у агента есть инструменты графа. Большинство CLI подхватывают их без перезапуска; уберите
стрелку — и они пропадут.

## Что умеет агент

| Инструмент | На что отвечает |
| --- | --- |
| `codegraph_search_graph` | Найти функции, классы и другие символы по имени, шаблону или смыслу |
| `codegraph_trace_path` | Кто вызывает функцию и что вызывает она — на несколько шагов вглубь |
| `codegraph_get_code_snippet` | Исходник одного символа, не открывая весь файл |
| `codegraph_query_graph` | Запросы Cypher (только чтение) для многошаговых вопросов |
| `codegraph_get_architecture` | Языки, пакеты, точки входа, маршруты, горячие места |
| `codegraph_search_code` | Текстовый поиск, ранжированный по графу |
| `codegraph_get_file_outline` | Всё, что объявлено в одном файле |
| `codegraph_detect_changes` | Какие символы задевают ваши незакоммиченные изменения |
| `codegraph_get_graph_schema`, `codegraph_index_status`, `codegraph_check_index_coverage` | Что в графе и насколько он полон |
| `codegraph_reindex` | Переиндексировать сейчас, сразу после правок |

Можно просто попросить: «найди через граф кода всё, что вызывает `validateOrder`».

## Карточка

- **Главное** — сколько символов в графе, сколько файлов, вызовов и связей и актуален ли он.
- **Поиск** — введите имя и посмотрите, где оно объявлено.
- **Что внутри** — функции, интерфейсы, классы, типы и языки проекта.
- **Кто пользуется** — подключённые агенты и их последний вызов графа.

## Всегда актуален

С включённым **Автообновлением** (по умолчанию) карточка замечает изменения файлов и через несколько
секунд переиндексирует — только изменённое, поэтому быстро. Ещё она обновляет граф, когда
подключённый агент заканчивает ход. Выключите — и обновляйте вручную кнопкой **Обновить**.

> Граф строится по папке воркспейса. Агент в изолированном worktree всё равно спрашивает граф основной
> папки.

## Воркспейсы в WSL и по SSH

Для воркспейса внутри WSL или на SSH-хосте движок работает **там**, рядом с кодом. Карточка
показывает где — **WSL · Ubuntu** или **SSH · ваш хост**:

- **Скачать** загружает Linux-сборку движка (x86-64 или ARM64 — по процессору хоста) и проверяет
её здесь; первая **Построить граф** копирует её в собственную папку NeuroSquad на той стороне
(`~/.neurosquad`), проверяет ещё раз и распаковывает там — один раз на дистрибутив или хост.
- Граф тоже лежит в этой папке. В проект и в остальную домашнюю папку там ничего не пишется, а код
не приходит на этот компьютер: агенты получают ответы на свои запросы.
- Актуальность: для проекта WSL на диске Windows (`/mnt/c/…`) карточка следит за файлами как обычно;
в остальных случаях обновляет граф после хода подключённого агента и по кнопке **Обновить**.
- Удаление карточки (или воркспейса) удаляет граф на той стороне; выход из NeuroSquad останавливает
движок там.

Движок работает только на Linux: для SSH-хоста на macOS карточка скажет «Для этого хоста нет сборки
движка».

## Приватность и хранение

Всё работает на вашем компьютере. codebase-memory-mcp ничего никуда не отправляет — ни аккаунта, ни
телеметрии, код не покидает машину. Движок и граф лежат в папке данных NeuroSquad: в проект и в
домашнюю папку ничего не пишется, а если у вас установлен свой codebase-memory-mcp, он продолжает
работать отдельно. Удалите карточку — удалится и её граф.

codebase-memory-mcp создан DeusData и распространяется по лицензии MIT.
