I bet you’ve been in this scenario: you are committing something to a Git repository and it fails.
Perhaps a pre-commit hook fails. Perhaps you are using a secure smartcard (including a YubiKey) to sign your commit, but it isn’t plugged in. Or you type in your PIN or GPG passphrase wrong. Or you’ve accidentally got an
.git/index.lock file in the way and you need to clear it before committing. Or maybe your EDITOR environment variable is set wrong. You’ve attempted to commit. It fails.
You’ve fixed whatever makes it not fail. You want to commit again and use the beautiful commit message you wrote a few minutes ago when it failed.
git commit -F .git/COMMIT_EDITMSG
When your commit fails, it stores the message in a file called
.git/COMMIT_EDITMSG. This merely commits with the contents of that file as your commit message.
--file takes a file name and uses that as the commit message, similarly to how
-m takes a message on the command line.
On my computer, I’ve set it up as an alias (
git retry-commit). Which I probably won’t remember.