Revdiff: Терминальный просмотрщик различий со встроенными аннотациями для AI-агентов

Что делает Revdiff

Revdiff — это терминальный интерфейс (TUI) для просмотра различий, разработанный для конкретного рабочего процесса: проверки изменений в коде, сгенерированных ИИ, без выхода из терминальной сессии, в которой работает ИИ-агент. Инструмент позволяет аннотировать строки, блоки или файлы и передавать эти аннотации напрямую ИИ-агенту для обработки.

Основной рабочий процесс

Из сессии Claude Code вы можете ввести /revdiff main или сказать "просмотреть различия за последние 3 коммита", чтобы открыть revdiff как терминальное наложение поверх сессии агента. После просмотра различий и добавления аннотаций вы выходите, и аннотации сразу же отправляются обратно агенту. Когда агент завершает внесение изменений, revdiff автоматически открывается с новыми изменениями, создавая непрерывный цикл, пока вы не выйдете без оставления аннотаций.

Интеграция с планированием

Отдельный плагин revdiff-planning подключается к режиму планирования Claude Code. Когда агент завершает план и вызывает ExitPlanMode, revdiff автоматически открывается на тексте плана. Вы можете аннотировать части, с которыми не согласны или которые хотите расширить, выйти, и агент пересмотрит план перед написанием любого кода.

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

• Двухпанельный TUI: дерево файлов слева, подсвеченный синтаксисом diff справа
• Навигация в стиле Vim с поиском (/search), переключением блоков и подсветкой изменений на уровне слов
• Блоки с информацией об авторе и возрасте коммита для каждой строки
• Свёрнутый режим diff, показывающий итоговый текст с маркерами изменений
• Режим переноса слов с маркерами продолжения
• Индикаторы горизонтальной прокрутки с маркерами « / »
• Номера строк с боковыми блоками для старых/новых версий в diff
• Поддержка Mercurial с автоматическим определением и преобразованием ссылок в стиле git
• Автоопределение одного файла, скрывающее панель дерева для полного просмотра diff
• Всплывающий список аннотаций для просмотра всех аннотаций по файлам
• Строка состояния с именем файла, статистикой diff, позицией блока и индикаторами режима
• Наложение справки, показывающее все сочетания клавиш, сгруппированные по разделам
• Навигация по оглавлению Markdown для одиночных файлов Markdown
• Режим всех файлов для просмотра и аннотирования всех файлов, отслеживаемых git
• Просмотр файлов без git для файлов вне репозиториев
• Просмотр буфера для произвольного текста, переданного через pipe или перенаправление
• История проверок автоматически сохраняется в ~/.config/revdiff/history/

Настройка

Revdiff предлагает 7 встроенных цветовых тем, переназначаемые сочетания клавиш и переопределения цветов через флаги CLI, переменные окружения или файл конфигурации. Вы можете экспортировать сочетания клавиш по умолчанию с помощью --dump-keys.

Установка и использование

Установите через Homebrew: brew install umputun/apps/revdiff. Инструмент представляет собой один бинарный файл — просто запустите revdiff HEAD~3, чтобы просмотреть последние 3 коммита. Работает с репозиториями git и Mercurial.

Поддержка плагинов

Доступны готовые плагины для Claude Code (терминальное наложение через tmux, Zellij, kitty, wezterm, Kaku, cmux, ghostty, iTerm2 или Emacs vterm), Codex и pi. Плагин Claude Code требует один из поддерживаемых терминалов, так как сам Claude Code не может отображать интерактивные TUI-приложения.

Технические детали

Написано на Go и имеет открытый исходный код под лицензией MIT. Требует git или hg для генерации различий (опционально при использовании --only или --stdin).