Rewrite Git history to purge secrets, binaries, or accidental paths before sharing a repo
Use git-filter-repo when an agent needs to surgically rewrite repository history after a leaked secret, a huge binary commit, or a bad subtree split. The agent analyzes the problem, builds the rewrite command, and leaves a clean follow-up checklist for force-push, clone reset, and downstream cleanup.
Prerequisites
git >= 2.36.0, python3 >= 3.6
Installation
Use the upstream install or setup path that matches your environment:
- git clone file://$(pwd) newcopy
Requirements and caveats from upstream:
- Prerequisites
- filter-repo requires:
- is all contained in a single-file python script named
Basic usage or getting-started notes:
git >= 2.36.0
python3 >= 3.6
Extracted from upstream docs: https://raw.githubusercontent.com/newren/git-filter-repo/HEAD/README.md