Граф кода
Чтобы ответить «что вызывает processOrder?», агент обычно запускает grep, открывает файл, снова
grep, открывает следующий — и тратит тысячи токенов на код, который ему не нужен. Плагин Граф кода
индексирует код воркспейса в граф знаний — функции, классы, методы, вызовы, импорты, маршруты — с
помощью codebase-memory-mcp , открытого движка от
DeusData. Подключённый агент спрашивает граф и получает ответ одним вызовом.
Как пользоваться
- В меню добавления карточки выберите Плагины, откройте Граф кода на вкладке Плагины и нажмите Добавить на канвас.
- Нажмите Скачать на карточке. NeuroSquad скачает официальную сборку codebase-memory-mcp с GitHub (около 40 МБ, около 300 МБ после распаковки) и сверит её с контрольной суммой, зашитой в приложение, — несовпадающий файл удаляется. Это нужно один раз.
- Нажмите Построить граф. Большинству проектов хватает секунд, очень большому — нескольких минут.
- Проведите стрелку от агента к карточке.
Теперь у агента есть инструменты графа. Большинство 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.