Git compatibility

• Compatible Git versions
• Upgrading your version of Git
  • Windows (Git for Windows)
  • Windows (Windows Subsystem for Linux)
  • macOS (Built-in Git)
  • macOS (Homebrew)
  • Linux (Debian derivatives, including Ubuntu)

Compatible Git versions

You can check your installed version of Git by running git version.

The following versions of Git have been tested with git-branchless:

Git version	Compatible?	Supports undo?	Notes
≤ 2.17	❌	❌	git move invocations may fail. label/reset/merge commands for git rebase -i not implemented until Git v2.18.
2.18–2.23	?	?	Untested, but may still work.
2.24–2.27	✅	❌
2.28	❌	❌	Bug related to reference-transaction support. No intention to fix at this time; upgrade your Git version. File an issue if you really need Git v2.28.
2.29	✅	✅	First version with git undo support.
2.30	✅	✅
2.31	✅	✅	Git v2.31+ are supported in git-branchless v0.3.2 or later.
2.32–2.36	✅	✅
master			See latest test run:

Upgrading your version of Git

Upgrading Git depends on your operating system. Below are instructions for a few popular operating systems.

Windows (Git for Windows)

Manual Download: Git for Windows

Using Chocolatey (as Admin!):

choco upgrade git

Using WinGet:

winget upgrade git

Windows (Windows Subsystem for Linux)

sudo add-apt-repository 'deb http://ppa.launchpad.net/git-core/ppa/ubuntu groovy main'
sudo apt update
sudo apt install git

macOS (Built-in Git)

You can upgrade your version of macOS, as Big Sur has a recent version of Git (v2.30) available at /usr/bin/git. If you can't upgrade macOS, follow the instructions for Homebrew below.

macOS (Homebrew)

brew install git  # If you don't have Git installed via Homebrew already.
brew upgrade git  # If you do.

Linux (Debian derivatives, including Ubuntu)

sudo add-apt-repository ppa:git-core/ppa
sudo apt update
sudo apt install git