HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Git-knife – スプレッドシートのようにコミットメッセージ、作成者、日付を編集

Show HN: Git-knife – edit commit messages, authors, and dates like a spreadsheet (github.com)

147 pointsby YonathanTesfaye96 コメント

要約

Git-knifeは、コミットメッセージ、作成者、日付などのGit履歴メタデータをスプレッドシートのようなGUIで編集できるデスクトップアプリケーションです。既存のGUIツールが苦手とするコミット日付の編集や、一括検索・置換機能を提供し、git commit-treeを使用してコミットを再構築することで安全に履歴を書き換えます。プッシュ済みの履歴を編集する際の警告や、編集前のバックアップ機能も備えています。

全文翻訳

git-knife 🔪

コミットのメッセージ、作成者、日付をテーブルのように編集して、Gitの履歴を整形します。

[画像: git-knife screenshot]

コミットのメタデータ(メッセージ、作成日時、コミッター日時、作成者名/メールアドレス)を直接編集するための、洗練されたデスクトップGUIです。

既存のGUIツール(GitKraken、Sublime Merge、Fork、lazygitなど)は、コミットメッセージの書き換えや並べ替えは得意ですが、コミットの日付は事実上変更不可能として扱っており、任意のコミットのコミッター日時や作成者情報を公開していません。それらのメタデータを書き換えられるツール(git-filter-repo、git rebase の環境変数トリック、git commit-tree)にはGUIがありません。git-knifeはこのギャップを埋めます。

git-knifeはGitを再実装するのではなく、システムのgit CLIにシェルアウトし、git commit-treeを使用してコミットを再構築します。各コミットの元のツリーを再利用するため、ファイルの内容が変更されていないことは証明可能です。

比較

ツールクリーンなGUIメッセージ書き換え並べ替え/squash/削除作成日時編集コミッター日時編集作成者/メール編集一括検索・置換(正規表現)
git-knife✅✅🚧 計画中✅✅✅✅
GitKraken✅✅✅⚠️ amendのみ❌⚠️❌
Sublime Merge✅✅✅⚠️ amendのみ❌⚠️❌
Fork✅✅✅❌❌⚠️❌
SmartGit✅✅✅⚠️❌✅❌
git-cola◐✅✅✅❌✅❌
lazygit (TUI)◐ TUI✅✅❌❌⚠️❌
git-filter-repo (CLI)❌✅コールバック経由✅✅✅✅

凡例: ✅ 一級品 · ⚠️ 可能だが扱いにくい/限定的 · ◐ 古いまたはターミナルUI · ❌ サポートなし · 🚧 計画中。

洗練されたGUIはメッセージの書き換えや並べ替えは得意ですが、コミットの日付(特にコミッター日時)を事実上変更不可能として扱っており、作成者情報を一括で正規表現で検索・置換する機能を提供するものはありません。メタデータを書き換えられるツールにはGUIがありません。git-knifeは、それらの交差点です。つまり、すべてのフィールドを一括で安全に編集できるクリーンなGUIです。

ステータス (MVP)

  • ✅ リポジトリを開き、ローカルブランチのいずれかを選択して表示/編集 — チェックアウトせずにリファレンスで編集するため、作業ツリーは一切変更されません。
  • ✅ メッセージ / 作成者名+メール / 作成日時 / コミッター日時 / コミッター名+メールを編集。
  • ✅ これらのテキストフィールド全体で一括検索・置換(リテラルまたは正規表現)。誤ったメールアドレスをすべて修正するのに便利です。
  • ✅ 適用前にすべての変更をプレビュー。
  • ✅ 各書き換え前に自動バックアップリファレンスを作成し、ワンクリックで復元可能。
  • ✅ すでにプッシュされた履歴に影響を与える書き換えを行う場合に警告。
  • ✅ サイン付きコミット対応 — サイン付きコミットをバッジ表示し、書き換えによって署名が削除されることを警告し、キーを使用して再署名できます。
  • ✅ マージコミットを跨いだ編集 — 完全なコミットグラフを再構築し、各マージの親を保持します。
  • ⛔ 未実装: 並べ替え / squash / 削除、ステージング/ブランチ/リモート。

要件

  • git (2.x)
  • Node.js + pnpm (corepack enable pnpm または npm i -g pnpm)
  • Rust (stable) — https://rustup.rs からインストール。
  • Tauri v2 用の Linux システム依存関係: webkit2gtk-4.1, libgtk-3, libayatana-appindicator3, librsvg2 (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 ビルドではTauriクレートがダウンロード・コンパイルされます(数分かかります)。

バンドルビルド

pnpm tauri build

パッケージ化(tauri build)にはアプリアイコンが必要です。これらは src-tauri/icons/ にコミットされています。任意の正方形のPNGから pnpm tauri icon path/to/icon.png で再生成できます。開発実行には不要です。

自動リリース (GitHub Actions)

.github/workflows/release.yml は、tauri-action を使用して macOS、Linux、Windows 用のネイティブインストーラーをビルドし、下書きのGitHubリリースに添付します。タグをプッシュしてリリースを作成します:

git tag v0.1.0
git push origin v0.1.0

(または、リポジトリの Actions タブから手動でトリガーします)。コード署名はまだ設定されていないため、macOS/Windowsビルドは署名なしです。初期テスターには問題ありません。

履歴の編集とプッシュ

コミットの編集
  1. リポジトリを開く(Browse… またはパスを貼り付け)、次にドロップダウンからブランチを選択します — git-knifeはチェックアウトせずにリファレンスで編集するため、作業ツリーと現在のチェックアウトはそのままです。
  2. マージコミットでないコミットをクリックしてエディターを展開します。
  3. メッセージ、作成者/コミッター名、メールアドレス、または日付を変更します。編集された行はハイライト表示されます。日付フィールドはコミットの元のUTCオフセットを保持します。
  4. Review & apply をクリックし、古いものと新しいもののプレビューを確認して、確認します。

git-knifeはローカルブランチのみを書き換えます。リモートに接続したり、自動でプッシュしたりすることはありません。プッシュは常に明示的なステップです。

一括検索・置換

コミットテーブルの上にある Bulk find & replace をクリックして、複数のコミット間で一度にテキストを変更します:

  • 対象とするフィールド(メッセージ、作成者/コミッター名、作成者/コミッターメール — 任意の組み合わせ)を選択します。
  • Find / Replace を入力します。パターンマッチングには Regex をトグルして $1 バックリファレンスを使用します。オフの場合はリテラル検索になります。デフォルトでは大文字小文字を区別します。
  • パネルには、一致するコミット数と置換数がリアルタイムで表示されます。Stage edits をクリックして編集をハイライト表示された行に変換し、通常通り Review & apply します。

例 — すべてのコミットを古いメールアドレスから新しいものに変更する: Author email + Committer email を対象とし、old@example.com を検索して new@example.com に置換します。マージコミットも含まれ、 successive passes compose。

書き換え後のプッシュ

コミットを編集すると、そのコミットのハッシュとそれ以降のすべてのコミットのハッシュが変更されるため、ローカルブランチとリモートが分岐します。通常の git push は非ファストフォワードとして拒否されます。リース付きでプッシュします:

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

--force-with-lease は、リモートが前回のフェッチ以降に移動した場合にプッシュを拒否するため、チームメイトのコミットをサイレントに上書きするのを防ぎます。この安全チェックをスキップするプレーンな --force よりもこちらを推奨します。

git-knifeは、編集が既にリモートに存在するコミットにまで及ぶ場合、「rewrites pushed history」という警告を表示します。可能であれば、プッシュされていないコミットのみを編集してください — 共有履歴の書き換えは、他の全員に再同期を強制します。

共有履歴を書き換えた後

古いコミットを既にプルした人は誰でも、履歴が分岐した状態になります。彼らはそれぞれ、ローカルブランチを新しいリモート状態に再同期します:

git fetch origin
git reset --hard origin/<branch>   # ローカル専用コミットを破棄 — 事前に調整してください
書き換えの取り消し
  • アプリ内: Backups パネルで、ワンクリックで書き換え前の先端を復元できます。

  • CLIから: 各適用で書き換え前のバックアップリファレンスが保存されています —

    git for-each-ref refs/knife-backup      # 書き換え前の先端を探す
    git reset --hard <backup-ref-or-hash>   # ブランチを元に戻す
    

    git reflog にも古い先端が表示されます。すでにフォースプッシュしてしまった場合は、ローカルで復元してから再度 git push --force-with-lease を実行してください。

サイン付きコミット

コミットを書き換えると、そのハッシュが変更され、コミットのすべてのGPG/SSH署名が無効になります(HNで提起された懸念事項)。git-knifeは、コミットの生の gpgsig ヘッダーを検出することで、署名付きコミットを検出します(検証とは独立しており、allowedSignersFile がなくてもSSH署名をキャッチします)。そして:

  • テーブルで signed とバッジ表示します。
  • 書き換えによって削除される署名付きコミットの数を、適用バーで警告します。
  • 設定されたキー(user.signingkey / gpg.format)で再署名するオプションを提供します。再署名がオンでもキーが設定されていない場合、適用は参照に触れる前に安全に失敗します。
署名ノート(透過的)

デフォルトでは、git-knifeは書き換えられた各先端コミットに、通常のノートに影響を与えない独自のノートリファレンスに、小さな開示されたノートを添付します:

git notes --ref=git-knife show <commit>   # 読む
git for-each-ref refs/notes/git-knife      # このリポジトリはgit-knifeで編集されましたか?

通常の git log では見えませんが(別リファレンス)、完全に検出可能です — 隠されたエンコーディングはありません。アプリの 🔪 signature note チェックボックス(設定は記憶されます)でいつでもオフにできます。リポジトリから完全に削除するには:

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

仕組み

  • src-tauri/src/git.rs — git をスパンする唯一の場所。
  • commits.rs — open_repo, list_commits (NUL/レコードセパレータ解析)。
  • rewrite.rs — preview_edits + apply_edits: 最も古い編集コミットから先端までを commit-tree を介して再構築し、バックアップリファレンスを保存して、古い先端に対する比較・スワップでブランチを移動します。
  • backup.rs — refs/knife-backup/* をリストし、git reset --hard で復元します。

書き換え戦略は、scratchpad/verify_engine.sh(正確なcommit-treeフローを再現し、コンテンツ差分が空であることをアサートする)によってGitレベルで検証されます。

安全性

すべての適用で、何も触れる前に古い先端を指す refs/knife-backup/<branch>/<epoch> が作成されます。何も強制削除されず、Backups パネルから常に復元可能です。