CodeGraph на Rust

Установка

Работает в

• Claude Code
• Cursor
• Codex
• SourceCraft
• Koda
• Coddy

Ручная установка

git clone https://github.com/Jakedismo/codegraph-rust
cd codegraph-rust
./install-codegraph-full-features.sh

Что делает

CodeGraph на Rust разбирает исходники проекта в дерево синтаксиса, связывает символы в граф и сохраняет его вместе с векторными представлениями в SurrealDB, которая встроена в бинарник `codegraph`. У каждого проекта свое хранилище в папке `.codegraph/db`. Глубину разбора задает уровень индексации: `fast` берет узлы и основные связи, `balanced` добавляет символы от языковых серверов и документацию, `full` включает все анализаторы, потоки данных и архитектуру. Агент подключает сервер по MCP и получает четыре инструмента. `agentic_context` собирает нужный контекст и отвечает на вопросы по коду, `agentic_impact` показывает цепочки зависимостей и вызовов, то есть что сломается при правке, `agentic_architecture` описывает структуру и публичные интерфейсы, `agentic_quality` находит сложные и сильно связанные места. Внутри каждого инструмента работает модель из `.env`: она сама выбирает операции над графом, связывает их в цепочку и возвращает пути файлов, номера строк и короткие выдержки. Те же инструменты доступны из оболочки командой `codegraph agent context "вопрос"`. Команда `codegraph init` предлагает хуки для Claude Code и Codex на уровне проекта, дописывает управляемый раздел в `AGENTS.md` и `CLAUDE.md` и запускает индексацию. Ключ `--watch` обновляет индекс, пока работает сервер.

Для кого. Для разработчиков, которые ведут большие репозитории с Claude Code, Cursor или Codex и хотят, чтобы агент сначала смотрел на связи в коде, а не читал файлы по одному.

Пример запроса к агенту

Построй граф кода этого проекта и покажи, какие модули сломаются, если я поменяю сигнатуру `UserService`

MCP

Транспорт

stdio

Авторизация

не нужна

Ограничения

• Автор не указал лицензию, права на использование и копирование не определены, уточните у автора. В тексте проекта названа MIT, но файла `LICENSE` в репозитории нет.
• Встроенное хранилище открывает один процесс на проект. Перед `codegraph index` остановите работающий `codegraph start`, а к проекту подключайте одного клиента. Отдельный демон не делит хранилище с запущенным сервером, для общей базы нужен свой сервер SurrealDB и переменная `CODEGRAPH_SURREALDB_URL`.
• Для уровней `balanced` и `full` нужны языковые серверы: `rust-analyzer`, `typescript-language-server`, `pyright-langserver`, `gopls`, `jdtls` или `clangd`. Если нужного нет, индексация сразу завершается ошибкой. Для Rust `rust-analyzer --version` проверяется из папки проекта.
• Уровень `fast` включен по умолчанию и отключает языковые серверы, обогащение и потоки данных. Связи `Uses` и `References` в граф не попадают. Полноту ответов определяет выбранный уровень и качество модели.
• Анализ нескольких репозиториев сразу и свои схемы графа автор держит в планах, сейчас их нет.

Как отключить. Уберите блок `codegraph` из MCP-конфигурации агента и остановите `codegraph start`. Индекс проекта удаляется командой `rm -rf <проект>/.codegraph/db`. Хуки Claude Code и Codex, которые добавил `codegraph init`, лежат в настройках проекта, а раздел `# codegraph` в `AGENTS.md` и `CLAUDE.md` убирается вручную.

Коротко о README

В репозитории рабочая область Cargo из отдельных крейтов, четыре установочных скрипта (полный, облачный, быстрый для macOS и базовый), пример конфигурации `config/example.toml`, руководства по установке и использованию, описание командной строки агента и тестовые сценарии `agentic_test_cases.py`. Основная страница проекта показывает пример ответа инструмента, таблицу уровней индексации, замеры точности по уровням и схему из клиента MCP, сервера и графового хранилища.