Revdiff: AIエージェント向けインライン注釈付きターミナル差分ビューアー

Revdiffの機能

Revdiffは、特定のワークフロー向けに設計されたターミナルユーザーインターフェース（TUI）差分ビューアです：AIエージェントが実行されているターミナルセッションを離れることなく、AI生成のコード変更をレビューします。このツールでは、行、ハンク、またはファイルに注釈を付けて、それらの注釈をAIエージェントに直接フィードバックして処理することができます。

コアワークフロー

Claude Codeセッションから、/revdiff mainと入力するか「最後の3コミットの差分をレビュー」と言うことで、エージェントセッションの上にターミナルオーバーレイとしてrevdiffを開くことができます。差分を読み、注釈を付けた後、終了すると、注釈は直接エージェントに戻ります。エージェントが変更を完了すると、revdiffは新しい変更に対して自動的に再開され、注釈を付けずに終了するまで、継続的なループが作成されます。

プランニング統合

別のrevdiff-planningプラグインは、Claude Codeの計画モードにフックします。エージェントが計画を完了しExitPlanModeを呼び出すと、revdiffは計画テキスト上で自動的に開きます。同意できない部分や拡張したい部分に注釈を付け、終了すると、エージェントはコードを書く前に計画を修正します。

主な機能

• 2ペインTUI：左側にファイルツリー、右側にシンタックスハイライトされた差分
• /検索、ハンクジャンプ、単語レベルの変更ハイライトを備えたVimスタイルのナビゲーション
• 行ごとの著者名とコミット経過時間を表示する責務ガター
• 変更マーカー付きの最終テキストを表示する折りたたみ差分モード
• 継続マーカー付きのワードラップモード
• « / »マーカー付きの水平スクロールオーバーフローインジケーター
• 差分用の新旧ガター付き行番号
• 自動検出とgitスタイルの参照変換を備えたMercurialサポート
• 単一ファイル自動検出でツリーペインを非表示にし、全幅差分ビューを実現
• ファイル全体のすべての注釈を閲覧する注釈リストポップアップ
• ファイル名、差分統計、ハンク位置、モードインジケーターを含むステータスライン
• セクション別に整理されたすべてのキーバインドを表示するヘルプオーバーレイ
• 単一ファイルマークダウンファイル用のマークダウン目次ナビゲーション
• すべてのgit追跡ファイルを閲覧および注釈付ける全ファイルモード
• リポジトリ外のファイルのための非gitファイルレビュー
• 任意のパイプまたはリダイレクトテキストのためのスクラッチバッファレビュー
• ~/.config/revdiff/history/に自動保存されるレビュー履歴

カスタマイズ

Revdiffは、7つのバンドルカラーテーマ、再マップ可能なキーバインド、CLIフラグ、環境変数、または設定ファイルを介した色ごとのオーバーライドを提供します。デフォルトのキーバインドは--dump-keysでエクスポートできます。

インストールと使用方法

Homebrew経由でインストール：brew install umputun/apps/revdiff。このツールは単一のバイナリです - 最後の3コミットをレビューするにはrevdiff HEAD~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を使用する場合はオプション）。