git-lrc

git-lrc: Бесплатное AI-ревью кода в реальном времени через Git Hooks

Современные инструменты генеративного ИИ значительно ускоряют написание кода, действуя как мощный акселератор. Однако высокая скорость без должного контроля может привести к проблемам: AI-агенты могут случайно удалять важную логику, изменять поведение системы или допускать утечку конфиденциальных данных. git-lrc — это ваша «тормозная система» для разработки, которая гарантирует, что каждый фрагмент кода проходит проверку перед тем, как попасть в проект.

Что такое git-lrc?

git-lrc — это утилита с открытым исходным кодом, предназначенная для проведения неограниченного количества AI-ревью кода прямо в момент выполнения команды git commit. Она работает как Git Hook, перехватывая изменения в стейджинге и отправляя их на анализ искусственному интеллекту.

Инструмент использует Google Gemini API для анализа кода, что позволяет разработчикам использовать щедрый бесплатный уровень API без посредников и лишних затрат. git-lrc обеспечивает мгновенную обратную связь, помогая выявлять:

• Утечки учетных данных и секретов.
• Дорогостоящие вызовы облачных сервисов.
• Наличие чувствительных данных в логах.
• Скрытое удаление логики или изменение поведения.

Основные возможности git-lrc

Продукт предлагает богатый функционал для обеспечения качества кода:

• Автоматизация через Hooks: После установки инструмент работает глобально на всей машине. Каждая попытка коммита в любом репозитории вызывает автоматическое AI-ревью.
• Интуитивно понятный интерфейс ревью:
  • Дифф в стиле GitHub с цветовой кодировкой.
  • Встроенные (inline) AI-комментарии с индикаторами серьезности проблем.
  • Общее резюме проверки и список измененных файлов.
  • Удобная навигация по замечаниям без необходимости прокрутки.
• Прозрачность и логирование: Каждый коммит получает отметку в git log, указывающую количество итераций ревью и процент покрытия кода проверкой (например, LiveReview Pre-Commit Check: ran (iter:3, coverage:85%)).
• Гибкость управления: Вы можете принять замечания и закоммитить код, поручиться за изменения лично (vouch) или пропустить проверку (skip).
• Бесплатность и открытость: git-lrc доступен на GitHub, не требует привязки кредитной карты и не имеет ограничений по количеству проверок.

Как использовать git-lrc

Процесс работы с git-lrc интегрируется в привычный рабочий процесс разработчика.

Установка и настройка

1. Установка: Выполните команду для macOS/Linux: curl -fsSL https://hexmos.com/lrc-install.sh | sudo bash
2. Настройка: Запустите процесс конфигурации, который займет не более минуты: git lrc setup Вам потребуется получить API-ключ LiveReview (через Hexmos) и бесплатный API-ключ Gemini в Google AI Studio.

Повседневное использование

Существует два основных сценария работы:

Вариант А: Автоматическое ревью при коммите

1. Подготовьте файлы: git add .
2. Запустите коммит: git commit -m "описание" — интерфейс ревью откроется автоматически.

Вариант Б: Ручной запуск перед коммитом

1. Проверьте изменения: git lrc review
2. Если вы уверены в коде, используйте: git lrc review --vouch
3. Завершите коммит: git commit -m "описание"

Справочник команд

| Команда | Описание | | :--- | :--- | | lrc review | Запустить ревью проиндексированных изменений | | lrc review --vouch | Пропустить AI, взяв личную ответственность за код | | lrc review --skip | Пропустить ревью для текущего коммита | | lrc hooks disable | Отключить хуки для текущего репозитория | | lrc self-update | Обновить инструмент до последней версии |

Сценарии использования (Use Case)

• Работа с AI-агентами: Когда вы генерируете код через Cursor, Windsurf или Copilot, git-lrc служит вторым уровнем контроля, проверяя работу ИИ перед фиксацией изменений.
• Предотвращение регрессий: В больших проектах, где случайное удаление логики может быть критичным, автоматическое ревью подсветит опасные изменения.
• Командная дисциплина: Метки в логах позволяют команде видеть, какие части кода были проверены AI, а какие приняты разработчиком «под честное слово».

FAQ (Часто задаваемые вопросы)

Какие данные отправляются на анализ? Анализируется только текущий дифф (staged changes). Полный контекст репозитория не загружается, и ваши данные не сохраняются после завершения ревью.

Можно ли отключить git-lrc для конкретного проекта? Да, для этого достаточно выполнить команду git lrc hooks disable внутри нужной папки репозитория.

Можно ли проверить уже сделанный коммит? Да, используйте команду git lrc review --commit HEAD для проверки последнего коммита или укажите диапазон, например HEAD~3..HEAD.

Почему это бесплатно? git-lrc работает по принципу "Bring Your Own Key" (используйте свой ключ). Поскольку вы используете собственный бесплатный лимит Gemini API, сервис LiveReview не взимает плату за координацию проверок.