revdiff CLI
CLI открывает правки и документы в терминале, чтобы человек оставил замечания к строкам и передал их кодовому агенту
- 945 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Программа читает код и сохраняет историю с аннотациями
- Плагин передает отзыв модели, которая может предложить или выполнить изменения с правами клиента
Установка
- Работает в
Ручная установка
brew install umputun/apps/revdiffУстановка готового терминального инструмента для macOS и Linux.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Программа читает код и сохраняет историю с аннотациями
- Плагин передает отзыв модели, которая может предложить или выполнить изменения с правами клиента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
revdiff открывает изменения кода в терминальном интерфейсе и позволяет оставить комментарии к строкам. Слева находится дерево файлов, справа правки и контекст. При выходе программа выводит аннотации, которые можно передать кодовому агенту. Кроме разницы между версиями можно просмотреть целый файл или текст из стандартного ввода. Программа умеет выделять измененные слова и переходить между фрагментами правок. Отдельные режимы показывают все отслеживаемые файлы или только выбранные пути. Интеграции с Claude Code и Codex открывают ревью рядом с сессией агента. Пользователь пишет замечания, а агент разбирает их после закрытия интерфейса. Замечания сохраняют привязку к файлу и строке.
Для кого. Ревьюерам кода и технических документов, которые передают агенту замечания к конкретным строкам.
Подходит, если
- После доработки нужно отметить спорные строки и вернуть замечания тому же агенту
- План или документ требуется проверить целиком без открытия отдельного редактора
- Для запроса на слияние нужно просмотреть патч, который еще не применен к рабочей копии
- Нужно повторно открыть сохраненные замечания после прерывания интерактивного ревью
Не подходит, если
- Нужно найти все ошибки кода без участия человека
- В окружении нельзя открыть поддерживаемый интерактивный терминал
- Отзыв должен автоматически публиковаться в GitHub без отдельной интеграции
Пример запроса к агенту
Открой изменения текущей ветки в revdiff, чтобы я оставил замечания. После выхода перечисли их и предложи план исправлений; до согласования код не меняй.Ограничения
Сравнение ревизий требует Git, Mercurial или Jujutsu; обычный файл можно смотреть без них, а панели авторства Jujutsu нужна версия 0.27 или новее. Сборка из исходников требует Go 1.26, готовый бинарник работает без Go. Плагину агента нужен поддерживаемый терминал, например tmux, kitty или WezTerm; способ запуска зависит от него. При выходе с аннотациями история сохраняется в `~/.config/revdiff/history/` и может содержать код: проверьте комментарии перед передачей модели.
Как отключить. Закройте интерфейс ревью и отключите установленный плагин в клиенте агента. CLI удалите через свой менеджер пакетов. Сохраненные аннотации и историю просмотрите отдельно: отключение программы их не стирает.
Частые вопросы
Как открыть только подготовленные к коммиту правки?
Выполните `revdiff --staged` в репозитории. Для сравнения двух ревизий используйте, например, `revdiff HEAD~1 HEAD`. Сначала проверьте, что выбран нужный диапазон.
Как проверить отдельный Markdown-файл?
Используйте `revdiff --only README.md`, заменив путь своим файлом. Такой просмотр работает и вне репозитория. Для Markdown доступна навигация по заголовкам.
В каком формате возвращаются замечания?
Это текст с заголовками, где указаны файл, строка и тип изменения. После заголовка идет комментарий. Вывод можно сохранить и передать агенту или обработать своим скриптом.
Что делать, если нужна только справка от агента?
Добавьте `??` в аннотацию. Плагины трактуют такой комментарий как вопрос и сначала готовят объяснение. Остальные замечания могут остаться запросами на правку.
Код завершения 10 означает ошибку?
Нет, если включен `--exit-code-on-annotations`: так программа сообщает о комментариях. Плагины считают это успешной передачей отзыва. По умолчанию этот способ сигнализировать об аннотациях выключен.
Какая лицензия у revdiff?
MIT.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI и плагин для ревью кода агентом: читает git diff и пишет замечания по строкам с учетом контекста
CLI сопоставляет диагностику линтеров с изменениями кода и выводит замечания локально или в согласованный канал ревью.
Open Code Review — командное ревью кода агентами
Open Code Review
Скилл и CLI для ревью кода: команда агентов-рецензентов смотрит изменения независимо, спорит о находках и выдает один отчет
CLI открывает локальный git diff в браузере как просмотр правок в пулл-реквесте GitHub; комментарии копируются промптом для агента
CLI превращает изменения Git в пошаговый разбор с кодом, вопросами и объяснениями от подключенного ИИ-агента
code-preview.nvim — просмотр правок агента в Neovim
code-preview.nvim
Плагин Neovim: правки Claude Code, OpenCode, Copilot CLI и Codex CLI открываются обычным диффом до записи на диск
Коротко о README
Есть отдельный плагин для проверки планов после их подготовки. Он устанавливается независимо от основного ревью правок. Темы, перенос строк и сочетания клавиш настраиваются в локальной конфигурации.