git-knife: 安全な Git 履歴整形ツール

git-knife

git commit-tree

既存の GUI ツールは日時変更に対応していない一方、CLI ツールには GUI がありません。

git-knife

機能比較概観

以下の表は主要な Git UI/CLI ツールの機能を比較しています。

凡例:

• ✅: 第一級機能
• ⚠️: 可能だが面倒、制限あり（Amend など）
• ◐: 旧式またはターミナル UI (TUI)
• ❌: 非対応
• 🚧: 予定中

現状の課題: 洗練された GUI ツールはメッセージや順序の編集には優れていますが、コミットの日時（特にコミッター日時）の変更や、著者情報の一括正規表現置換を支援するものは皆無です。一方、メタデータを再構築できる CLI ツールには GUI がありません。

git-knife

MVP ステータス (現時点での実装状況)

✅ 対応済み機能

• リポジトリのコミットリスト表示
• すべてのメタデータ編集:
  • メッセージ、著者名/メール、著者日付
  • コミッター名/メール、コミッター日付
• 一括検索・置換:
  • テキストまたは正規表現（例：誤ったメールアドレスの修正）による全件置換
  • 変更前のプレビュー表示
  • 適用前の自動バックアップ参照作成 + ワンクリック復元
  • リビルド操作への警告表示
• マージコミット: ロック済み（編集不可）

⛔ 未対応機能

• 順序入れ替え・結合・削除
• マージコミットの書き換え
• ステージング、ブランチ、リモートリポジトリの管理

インストールと開発環境

要件

• Git (2.x)
• Node.js + pnpm (

  corepack enable pnpm

  または

  npm i -g pnpm

  )
• Rust (stable): rustup.rs からインストール
• Linux システム用 Tauri 依存ライブラリ:

  # Debian/Ubuntu の場合
  sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
    libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
  

ローカル開発での実行

pnpm install
pnpm tauri dev

注：最初の

cargo build

では依存ライブラリのダウンロードとコンパイルが行われるため、数分かかります。

バンドルの構築 (パッケージング)

アイコンは既に

src-tauri/icons/

pnpm tauri icon path/to/icon.png

注：開発環境実行時には不要です。

オートメーションリリース (GitHub Actions)

.github/workflows/release.yml

tauri-action

タグを作成してリリースを切り出す方法：

git tag v0.1.0
git push origin v0.1.0

または、リポジトリの Actions タブ から手動でトリガーすることも可能です。

注：コード署名の設定はまだ行われていないため、ビルド結果は署名されていません（初期テスト段階では問題ありません）。

履歴の編集とプッシュ

コミットの編集手順

1. リポジトリを開く
   

   Browse…

   で選択するか、パスを直接貼り付けます。
2. コミットを選択・展開
   マージコミット以外の任意のコミットをクリックしてエディターを展開します。
3. メタデータを変更
   メッセージ、著者/コミッターの名前、メールアドレス、日時を変更します。
   • 変更された行はハイライト表示されます。
   • 日時フィールドは元の UTC オフセット を保持します。
4. 適用とレビュー
   

   Review & apply

   をクリックし、旧履歴 → 新履歴のプレビューを確認して承認します。

重要:

git-knife

はローカルブランチのみを書き換えます。リモートへ連絡したり自動プッシュしたりしません。プッシュは常にユーザーが明示的に行う必要があります。

一括検索・置換機能

コミットテーブル上部の [Bulk find & replace] ボタンをクリックして、複数のコミットを一度に編集します：

1. フィールド選択:
   メッセージ、著者・コミッター名、メールアドレスなど、任意の組み合わせを選択します。
2. パターン入力:
   • 検索条件と置換条件を入力します。
   • 正規表現を使用するには [Regex] を切り替え、

     $1

     などのバック参照を使います（デフォルトは文字通りの検索）。
   • デフォルト設定は区別大文字小文字に敏感です。
3. 適用:
   パネルで一致数と置換数がリアルタイムでカウントされます。
   [Stage edits] でハイライトされた行を確定し、通常通り

   Review & apply

   します。

例: メールアドレスの全件修正
著者メール + コミッターメールをターゲットにし、検索に

old@example.com

new@example.com

マージコミットはスキップされ、連続した操作は累積されます。

書き換え後のプッシュ

履歴の編集によりコミットのハッシュ値が変わるため、ローカルとリモート間に分岐が発生し、通常の

git push

git push --force-with-lease origin <branch>

• なぜ

  --force-with-lease

  か?
  リモート側が移動した場合にプッシュを拒否するため、チームメンバーのコミットが無断で上書きされることを防ぎます。単純な

  --force

  より推奨されます。

警告:
編集対象がアップストリーム（リモート）にある場合、「履歴を書き換えました」という警告が表示されます。共有された履歴を編集するのは、他の人にとって再同期を強制するためです。可能な限り未プッシュのコミットのみを編集することをお勧めします。

共有履歴を書き換えた後の対応

すでに古いコミットを取得しているユーザーは、分岐した履歴を持つことになります。各ユーザーはローカルブランチを新しいリモート状態に合わせて再同期する必要があります：

git fetch origin
git reset --hard origin/<branch>   # ローカルで新規作成されたコミットを破棄（事前調整が必要）

書き換えの取り消し（復元）

• アプリ内:
  バックアップパネルから、再構築前の先頭コミットをワンクリックで復元可能です。
• CLI から:
  適用操作ごとに

  refs/knife-backup/

  にバックアップ参照が保存されます：

git for-each-ref refs/knife-backup      # バックアップ参照を探す
git reset --hard <backup-ref-or-hash>   # ブランチを元に戻す

注:

git reflog

にも旧先頭コミットがリストされます。すでに強制的なプッシュを行っても、ローカルで復元してから再度

git push --force-with-lease

で対応できます。

サインノートについて (透明性)

デフォルトでは、再構築された各コミットに対して小さな公開ノート（Sign Note）が添付されます。これは通常のノート参照とは独立しており、

git-knife

ノートを確認する方法:

# ノートを読む
git notes --ref=git-knife show <commit>

# リポジトリが編集済みか確認
git for-each-ref refs/notes/git-knife

• 通常の

  git log

  には表示されませんが、完全に検出可能で隠蔽されていません。
• アプリ内の 🔪 サインノートチェックボックス でいつでもオフに切り替えることができます（設定は保持されます）。
• リポジトリから完全に除去するには：

git update-ref -d refs/notes/git-knife

仕組みとアーキテクチャ

コアコンポーネント

• src-tauri/src/git.rs

  
  Git を起動する唯一の場所。

• commits.rs

  
  リポジトリを開き、NUL レコードセパレータを使ってコミットをリストアップ（

  open_repo

  ,

  list_commits

  ）。

• rewrite.rs

  • preview_edits

    と

    apply_edits

    を処理。

  • git commit-tree

    を使用して、最初に変更されたコミットから先頭までのチェーンを再構築。
  • バックアップ参照を保存し、旧先頭での比較・交換（compare-and-swap）でブランチを移動。

• backup.rs

  
  バックアップ参照

  refs/knife-backup/*

  のリスト表示と復元処理（

  git reset --hard

  ）。

検証: 再構築戦略は

scratchpad/verify_engine.sh

で git レベルで検証されており、実際の

commit-tree

フローを再現してコンテンツ差分が空であることを断言しています。

セキュリティポリシー

すべての適用操作で、何も接触する前の旧先頭コミットへの参照

refs/knife-backup/<branch>/<epoch>

• 強制削除は行われません。
• 復元はいつでもバックアップパネルから利用可能です。