Installation

Prerequisites

Before installing Git Wrangler, make sure you have:

DependencyRequired forInstall
gitAll operationsgit-scm.com
ghclone, rename-repocli.github.com
git-filter-repoHistory rewritingGitHub

git is required for everything. gh and git-filter-repo are only needed if you plan to use their respective commands.

One-liner install

Run the following in your terminal:

curl -fsSL https://raw.githubusercontent.com/kaufmann-dev/git-wrangler/main/install | bash

This will:

  1. Clone the repository to ~/.git-wrangler
  2. Create a symlink at ~/.local/bin/git-wrangler (or /usr/local/bin as fallback)
  3. Verify the installation

Platform support

PlatformStatus
macOS✅ Native
Linux✅ Native
Windows (Git Bash)✅ Supported
Windows (WSL)✅ Supported

Verify the installation

git-wrangler help

You should see the help menu listing all available commands.

Updating

Keep Git Wrangler up to date by running:

git-wrangler update

This compares your local commit against the remote and applies the update if one is available.

Uninstalling

To remove Git Wrangler cleanly:

git-wrangler uninstall

This removes the ~/.git-wrangler directory and the git-wrangler symlink. No other files are touched.

Manual install

If you prefer to clone manually:

git clone https://github.com/kaufmann-dev/git-wrangler ~/.git-wrangler
ln -s ~/.git-wrangler/git-wrangler ~/.local/bin/git-wrangler
chmod +x ~/.git-wrangler/git-wrangler ~/.git-wrangler/libexec/git-wrangler-*