Installation

Install Git Wrangler and check that the tools you need are available.

Install on macOS or Linux

brew install kaufmann-dev/tap/git-wrangler

Install on Windows

scoop bucket add kaufmann-dev https://github.com/kaufmann-dev/scoop-bucket.git
scoop install kaufmann-dev/git-wrangler

Homebrew and Scoop also install Git, GitHub CLI, git-filter-repo, and shell completions.

Verify the installation

git-wrangler doctor

doctor tells you which tools are ready and which optional features still need setup.

Manual installation

Download the archive for your operating system from GitHub Releases, extract the git-wrangler binary, and place it somewhere on your PATH.

Manual installation does not install supporting tools or shell completions. Install only what your workflows need:

Tool Needed for
git All repository commands
gh Cloning and renaming GitHub repositories
git-filter-repo Removing secrets and rewriting authors, messages, dates, or coauthors

See completion if you installed the binary manually and want shell completions.

Set up optional features

Run setup when you want to access private GitHub repositories or use AI-assisted commit messages:

git-wrangler init

Update

Homebrew:

brew update
brew upgrade git-wrangler

Scoop:

scoop update
scoop update git-wrangler

For a manual installation, replace the existing binary with a newer release.

Uninstall

Homebrew:

brew uninstall git-wrangler
brew untap kaufmann-dev/tap

Scoop:

scoop uninstall git-wrangler
scoop bucket rm kaufmann-dev

For a manual installation, remove the binary from your PATH.