Installation

Install

macOS and Linux:

brew install kaufmann-dev/tap/git-wrangler

Windows:

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

Homebrew and Scoop install git, gh, git-filter-repo, and shell completions.

GitHub Releases

You can also install manually by downloading a standalone binary from GitHub Releases, extracting it, and adding it to your PATH.

Manual binary installs do not include runtime dependencies or shell completions. Install the dependencies below yourself as needed for the commands you run, and see completion for shell setup.

Run git-wrangler doctor after installation to check the local tools Git Wrangler can use.

Run git-wrangler init when you need private GitHub workflows or AI-assisted commits.

Update

Homebrew:

brew update
brew upgrade git-wrangler

Upgrade Scoop installs with:

scoop update
scoop update git-wrangler

Runtime dependencies

git is required for normal repository operations.

gh is required for GitHub repository operations such as clone and rename-repo. Git Wrangler owns the token and passes it to gh for those workflows. Run this before private or all-repository workflows:

git-wrangler init

GitHub credentials resolve from GIT_WRANGLER_GITHUB_TOKEN or Git Wrangler’s keyring entry. An inbound GH_TOKEN is ignored; Git Wrangler only sets GH_TOKEN for child gh processes after resolving its own credential.

git-filter-repo is required for history rewrite commands:

  • remove-secrets
  • rewrite-authors
  • rewrite-commits
  • normal rewrite-dates operations

rewrite-dates --rollback restores stored history without git-filter-repo.

AI features in commit and rewrite-commits require an OpenAI-compatible completions endpoint, a model, and an API key.

git-wrangler doctor reports missing git as an error because most commands need it. Missing gh or git-filter-repo is reported as a warning because those tools are only needed for specific workflows.

Uninstall

Homebrew:

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

Scoop:

scoop uninstall git-wrangler
scoop bucket rm kaufmann-dev

If installed manually, remove the binary from wherever you placed it on PATH.