OmniDiff：高速・堅牢かつ正確な差異検出ツール

OmniDiff は、99.95% のコード変更を検出できる高品質な内容認識型の差異検出ツールです。

基本特性

• 高速: 100ms 未満で完了（中位値）
• 堅牢: コードの変更の 99.95% を検出可能
• 正確:
  • 変更箇所の 98.8% は、内容特化アルゴリズムを使用して検出されます。
  • PDF などでは完全一致/ほぼ完全一致を達成しています。

対応対象と性能（概算）

※測定環境: 32GB RAM搭載の T14s (Intel Core i7-1370P) 上で実施。（詳細はリポジトリ参照） ※注意: PDF の判定テストケース数は 10 件未満です。

インストール方法

ソースコードからビルド

C コンパイラと Rust ツールチェーン (

rustc

cargo install --locked omnidiff

• 初回ビルド: tree-sitter グラムマタの C コンパイルと LTO の脂肪リリースプロファイル処理により数分かかります。

プリビルトバイナリ

Linux、macOS (Intel/Apple Silicon)、Windows 用は GitHub リリース に添付されています。

Homebrew (macOS/Linux)

brew install ivankovic/omnidiff/omnidiff

Debian と Ubuntu

.deb

# キーリング登録
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://ivankovic.github.io/omnidiff/apt/omnidiff-archive-keyring.gpg \
  | sudo tee /etc/apt/keyrings/omnidiff-archive-keyring.gpg > /dev/null

# リポジトリ追加
echo "deb [signed-by=/etc/apt/keyrings/omnidiff-archive-keyring.gpg] \
https://ivankovic.github.io/omnidiff/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/omnidiff.list > /dev/null

# インストール
sudo apt update && sudo apt install omnidiff

Nix および NixOS

nix run github:ivankovic/omnidiff

• ** flakes 有効化が必要な場合**:

  --extra-experimental-features 'nix-command flakes'

  を追加してください。

Arch と Gentoo

• packaging/

  ディレクトリにレシピあり。
• Arch:

  PKGBUILD

  で

  makepkg -si

  。
• Gentoo: ebuild は Overlay 即用。
• 注意: 両者のパッケージ受入れサイクルは不規則です。

エディタとの連携

VS Code

• 拡張機能名：

  omnidiff-vscode

• インストールコマンド:

  code --install-extension ivankovic.omnidiff

• Open VSX (VSCodium, Cursor, Windsurf 対応) でも利用可能。
• 注: 埋め込みの差分表示ビューを置換する機能は未提供（上流プロジェクト開発中）。

Neovim

• プラグイン名：

  omnidiff.nvim

コマンドラインでの使い方

インタラクティブ TUI（ターミナルユーザーインターフェース）

# 空のビューアを開く（o を押してファイル指定）
omnidiff 

# 2 つのファイルを直接差分表示
omnidiff BEFORE AFTER

• キーボード操作:

  ?

  で一覧を表示。
• カラー:

  COLORTERM=truecolor

  の場合、24 ビットカラーを使用（デフォルト）。

ブラウザ上での使用

• コマンド：

  codereview

  • 注意: 現在 v0.0.0 ベータ版です。ご自身の責任で使用してください。

Headless モード / バッチ処理

omnidiff --headless BEFORE AFTER
# または
omnidiff --batch BEFORE AFTER

• 機能: TUI を開かず、差分をプレーンテキストで出力（スクリプト・CI向け）。
• 自動発動: 標準出力がターミナルでない場合（

  | less

  やファイルリダイレクト）は自動的に発動。
• 折りたたみ: デフォルトでは変更の両側にコンテキスト 3 行を表示（

  --context N

  で変更可能）。大きなファイル内の関数定義などをプレフィックスに追加。
• カラー制御:
  • デフォルト：カラー有効
  • ANSI カラー無効:

    --color never

    または環境変数

    NO_COLOR=1

終了コード

• 成功 (0): 正常終了
• エラー (2): エラー発生
• ファイル違い (1):
  • デフォルトでは 0 を返す（バージョン管理システムとの親和性のため）。
  • スクリプト用途で「違いを検知」したい場合：

    --exit-code

    フラグを指定。

JSON 出力

omnidiff --mode json BEFORE AFTER

• 差分を 1 つの JSON オブジェクトとして出力（スキーマは

  src/tui/json_output.schema.json

  ）。

Git との連携

OmniDiff は

git difftool

構成設定 (手動)

# コマンド登録
git config difftool.omnidiff.cmd 'omnidiff "$LOCAL" "$REMOTE"'

# 使用開始
git difftool --tool=omnidiff

# デフォルトツールの指定
git config diff.tool omnidiff 

# プロンプト無効化（確認ダイアログを抑制）
git config difftool.prompt false

Git 動作の補足

• git difftool

  : インタラクティブ TUI を開く。

• git diff

  /

  git log -p

  : インタラクティブ TUI を開かず、TUI は非互換なパイプ出力となるためプレーンテキストフォールバック（Headless モード）へ。
  • インタラクティブ利用には必ず

    git difftool

    を使用してください。
• 外部差分ツールとして:

  GIT_EXTERNAL_DIFF=omnidiff git diff
  

Jujutsu (jj) との連携

jj

# 登録とデフォルト設定
jj config set --user merge-tools.omnidiff.program omnidiff
jj config set --user merge-tools.omnidiff.diff-args '["$left","$right"]'
jj config set --user merge-tools.omnidiff.diff-invocation-mode file-by-file

# デフォルトフォーマッターへ
jj config set --user ui.diff-formatter omnidiff

• diff-invocation-mode = "file-by-file"

  は必須です（ファイルごとの処理のため）。
• 全画面 TUI:

  jj diff

  のみ非インタラクティブテキスト表示。

  jj difftool

  相当の機能はありません。

対応するコンテンツ

構造的言語 (tree-sitter グラムマタ)

以下 25 の言語は構造的に解析され、高精度な差分検出が行われます：

.c

.h

.cs

.cc

.cpp

.cxx

.hpp

.hh

.hxx

.css

.scss

.go

.html

.htm

.java

.js

.mjs

.cjs

.jsx

.json

.kt

.lua

.pl

.pm

.php

.py

.pyi

.pyw

.r

.rb

.rs

.scala

.bash

.sh

.swift

.tsx

.ts

.mts

.cts

.vim

.xml

.xht

.svg

.plist

.yaml

.yml

※グラマタ未使用の言語: Bazel, Dart, Emacs Lisp, Markdown, Protocol Buffers, SQL などは拡張子から認識されますが、構造的差分ではなくテキストベースで検出されます。

バイナリコンテンツ

ファイル名ではなく内容に基づいて差異を判定します。

変更の分類

• 不可視: バイトのみが異なっている。
• 不可知: コンテンツの意味が不明確な変更。
• アーティファクト: 圧縮や再サンプリングによる変化。
• 編集済み / 再描画 / 置換: テキスト、空白、書式化などの具体的な変更。

画像表示について: TUI 内では

kitty

sixel

iterm2

b

OMNIDIFF_GRAPHICS=halfblocks

ライセンス

• GPL-3.0+ (AGPL): 自由ソフトウェア。ソースコード公開義務あり。
• 商業ライセンス: GitHub Sponsors 経由で月額サブスクリプション提供可能（内部利用向け、ソース公開義務なし）。詳細は

  LICENSE-COMMERCIAL

  を参照。

開発ガイドラインとポリシー

AI ポリシー

• 現在、Claude Code の大幅な AI アシスタンスを受けています。
• コミット履歴には事実を隠さず Co-Authored-By とリンクを含みます。
• AI 支援によるコントリビューションも同等に歓迎されますが、理解とサポートの責任は提出者にあります。

パフォーマンス目標（達成済み）

• 速度: メジアン（p50）100ms、90% 分位（p90）1000ms を目標達成。
  • コード測定結果: p50=4.2ms, p90=35.1ms, p99=177ms。

堅牢性の測定結果

• コード: 約 44 万ペアのうち 99.95% (442,322 ペア) が正常終了。
  • 失敗要因：予算超過（96 ペア）、メモリ制限超過（112 ペア）。
• 多様コンテンツ: テキスト・コンテンツを含め全体の 98.8% を検出可能。

正確性の測定結果

• コード: 0 バイト不一致のテストケース 90%, 最大 1% 不一致のテストケース 99%.
  • 全体コーパスでの不一致は 0.14%（

    --full

    モード）、0.07%（

    --minimal

    モード）まで改善。
• 多様コンテンツ:
  • 画像：ほぼ完全一致 91%
  • カーソル：完全一致 100%

貢献者向け情報

詳細は

CONTRIBUTING.md

AGENTS.md