tirth8205/code-review-graph

Локальный граф кодовой аналитики для MCP и CLI. Создает постоянное представление кодовой базы, чтобы AI-инструменты читали только важное, с оптимизацией контекста для ревью и работы с большими репозиториями.

MCP⭐ 31 668Pythonпоследний релиз: v2.3.9
Открыть на GitHub ↗Сайт проекта ↗

Что это за инструмент

code-review-graph — это локальный инструмент на Python, который строит структурный граф кодовой базы с помощью Tree-sitter для оптимизации контекста, передаваемого AI-ассистентам.

Зачем нужен

Инструмент решает проблему переплаты за токены и снижения качества ответов из-за избыточного контекста. Он отслеживает изменения в коде и предоставляет AI-инструментам через MCP только релевантные фрагменты, что позволяет сократить объем передаваемых данных в десятки раз без потери точности анализа.

Что можно реализовать

  • Оптимизация работы AI-ревьюеров кода в IDE (Cursor, Zed, Windsurf) для снижения затрат на токены.
  • Интеграция графа кодовой базы с CLI-инструментами (Claude Code, GitHub Copilot CLI, Gemini CLI) через протокол MCP.
  • Ускорение анализа больших репозиториев за счет передачи AI только измененных или связанных файлов.
  • Автоматическая настройка конфигурации MCP для различных платформ с помощью одной команды install.

Ключевые возможности

  • Автоматическое обнаружение и конфигурирование популярных AI-платформ (Codex, Copilot, Claude Code и др.).
  • Инкрементальное отслеживание изменений в кодовой базе с использованием Tree-sitter.
  • Сокращение объема контекста до 71 раз (по бенчмаркам) по сравнению с полным чтением репозитория.
  • Поддержка локального запуска (Local-first) для обеспечения конфиденциальности данных.
  • Готовые команды для установки, сборки графа и безопасного удаления (uninstall --dr).

👤 Кому подойдёт: Разработчики, использующие AI-ассистентов для код-ревью и навигации по коду, а также команды, стремящиеся оптимизировать расходы на LLM-токены при работе с большими кодовыми базами.

Релизы

v2.3.9minor
🕐 2 дн назад · релиз на GitHub ↗

Визуализация окрестностей, улучшенный поиск с учетом docstring и camelCase, автоматическое продвижение в staging/testing.

  • Added: Visualize теперь поддерживает отрисовку окрестностей узлов с помощью новых флагов, а не только всего репозитория.
  • Added: Ключевой поиск полностью переработан: добавлены индексы для docstring и токенизации camelCase, что значительно повысило точность.
  • Added: Добавлена автоматическая промоция ветки staging в testing при выполнении всех условий и проверок.
  • Added: Query_graph_tool теперь поддерживает разрешение точечных имен (dotted targets) через индекс nodes.symbol.
  • Added: Инструменты обновления теперь сообщают о файлах, не прошедших парсинг, сохраняя предыдущие данные графа.
v2.3.8patch
🕐 1 мес назад · релиз на GitHub ↗

Исправления watch-режима, канонизация путей репозиториев, лимиты токенов и честные пустые ответы.

  • Fixed: Устранены сбои watch-режима: исправлено игнорирование папок, обработка удалённых директорий и работа через симлинки.
  • Fixed: Канонизация путей репозитория: теперь разные варианты указания корня не дробят граф и не приводят к потере данных.
  • Fixed: Внедрены жёсткие лимиты токенов для ответов, чтобы избежать переполнения контекста и чётко маркировать усечённые данные.
  • Added: Появилось поле confidence в пустых результатах запросов, объясняющее причину нулевого ответа.
  • Added: Добавлен провайдер эмбеддингов Voyage AI с сохранением прогресса после каждого батча.
v2.3.7minor
🕐 2 мес назад · релиз на GitHub ↗

Релиз v2.3.7: расширен CLI, добавлена поддержка новых языков и фреймворков, закрыты уязвимости CodeQL, улучшена стабильность.

  • Added: Расширены возможности CLI: добавлены парсинг CommonJS, вывод в JSON/quiet-режиме, анализ мертвого кода и обогащение данных.
  • Added: Значительно расширено покрытие графа для Terraform, Ansible, VB.NET, SystemVerilog, Rust, PHP/Laravel, Julia, Python, C#, Java, Spring и WebFlux.
  • Added: Введены новые функции: транзитивное покрытие тестов, оценка риска изменений, взвешенный рейтинг влияния, провенанс графа и безопасный экспорт JSON.
  • Fixed: Улучшена безопасность и стабильность: закрыты три уязвимости CodeQL, усилен MCP, исправлена работа с процессами Windows и парсинг Git.
  • Added: Обновлены версии зависимостей и GitHub Actions, улучшена обработка конфигураций платформы и безопасный обзор форк-PR.