Installation
Prerequisites
Before installing Git Wrangler, make sure you have:
| Dependency | Required for | Install |
|---|---|---|
git | All operations | git-scm.com |
gh | clone, rename-repo | cli.github.com |
git-filter-repo | History rewriting | GitHub |
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:
- Clone the repository to
~/.git-wrangler - Create a symlink at
~/.local/bin/git-wrangler(or/usr/local/binas fallback) - Verify the installation
Platform support
| Platform | Status |
|---|---|
| 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-*