git-filter-repo mit Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper, scoop installieren

Projektlinks

• Homepage
• Upstream-Dokumentation
• Paketmanager-Seite

Befehle und Aliase

• git-filter-repo

Projektgeschichte

The project grew out of Newren's work on Git fast-export and fast-import based history filtering. The public repository carries imported history back to a 2009 initial import, while the standalone GitHub project was established in 2018 and began tagging releases alongside Git 2.23-era packaging. Its README frames the tool as a response to shortcomings in git filter-branch and BFG Repo Cleaner: poor performance, confusing multi-step cleanup, limited rewrite types, and fragile shell-based filtering.

Adoptionsgeschichte

Adoption was accelerated by the Git project's own filter-branch documentation, which warns against filter-branch for many use cases and points users toward git-filter-repo. The project became a standard answer for history-rewrite work because it combines a command-line interface, a Python library for custom filters, conversion guides from filter-branch and BFG, and packaging in common Unix package ecosystems.

Wie es verwendet wird

Practitioners use git-filter-repo for destructive repository rewrites: removing large blobs or secrets, extracting a subdirectory with history, moving a project into a subdirectory before a merge, renaming tags, rewriting author data with mailmap information, or replacing text across historical blobs. The tool deliberately encourages use from a fresh clone and performs cleanup steps such as pruning old history and repacking so users do not mix rewritten and original refs.

Warum Paket-Nerds sich dafür interessieren

For package maintainers and release engineers, git-filter-repo matters because it replaced a folklore-heavy set of filter-branch recipes with a single-file script, a documented manual, and reproducible transformations. Its existence also fed changes back into core Git fast-export and fast-import behavior, making it part of the broader Git tooling ecosystem rather than only a cleanup script.

Zeitleiste

• 2009: Imported predecessor history begins with an initial filter-repo commit.
• 2018: The standalone GitHub repository was created.
• 2019: Git Rev News published Newren's introduction to git-filter-repo.
• Git 2.23 era: Early tagged releases appeared as the tool entered package-manager distribution.

Related projects

• git-filter-repo is related to git filter-branch, BFG Repo Cleaner, git fast-export, git fast-import, and the filter-lamely and bfg-ish demos shipped in its contrib tree.

Quellen

• https://git-scm.com/docs/git-filter-branch
• https://git.github.io/rev_news/2019/08/21/edition-54/
• https://github.com/newren/git-filter-repo
• https://github.com/newren/git-filter-repo#readme
• https://github.com/newren/git-filter-repo/blob/main/Documentation/git-filter-repo.txt