git-filter-repo
brew install git-filter-repo
v2.47.0
MIT
Python tool for rapidly rewriting Git repository history with filtering, cleaning, and structural transformations.
Why you might care
Replaces the deprecated git filter-branch with much faster performance and broader capabilities for removing secrets, large files, sensitive data, or restructuring repos at scale. Includes a library API for building custom history-rewriting tools beyond simple command-line use. Official Git project recommendation over filter-branch.
8.5k
30-day installs · #398
24.9k
90-day · #444
79.9k
365-day · #494
12.6k
★ GitHub stars · updated 8d ago
Links
- https://github.com/newren/git-filter-repo
- GitHub: newren/git-filter-repo
- Brew formula source: Formula/g/git-filter-repo.rb
Blurb generated by claude-haiku-4-5 on today.
Raw metadata
{
"aliases": [],
"alternatives": [
"git filter-branch",
"BFG Repo Cleaner",
"git-crypt"
],
"build_dependencies": [],
"categories": [
"version-control",
"build-system"
],
"caveats": null,
"conflicts_with": [],
"dependencies": [],
"deprecated": 0,
"deprecation_reason": null,
"desc": "Quickly rewrite git repository history",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:38:03+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "git-filter-repo",
"github_default_branch": "main",
"github_last_commit_at": "2026-06-12T16:57:22Z",
"github_readme_excerpt": "git filter-repo is a versatile tool for rewriting history, which includes\n[capabilities I have not found anywhere\nelse](#design-rationale-behind-filter-repo). It roughly falls into the\nsame space of tool as [git\nfilter-branch](https://git-scm.com/docs/git-filter-branch) but without the\ncapitulation-inducing poor\n[performance](https://public-inbox.org/git/CABPp-BGOz8nks0+Tdw5GyGqxeYR-3FF6FT5JcgVqZDYVRQ6qog@mail.gmail.com/),\nwith far more capabilities, and with a design that scales usability-wise\nbeyond trivial rewriting cases. [git filter-repo is now recommended by the\ngit project](https://git-scm.com/docs/git-filter-branch#_warning) instead\nof git filter-branch.\n\nWhile most users will probably just use filter-repo as a simple command\nline tool (and likely only use a few of its flags), at its core filter-repo\ncontains a library for creating history rewriting tools. As such, users\nwith specialized needs can leverage it to quickly create [entirely new\nhistory rewriting tools](contrib/filter-repo-demos).\n\n# Table of Contents\n\n * [Prerequisites](#prerequisites)\n * [How do I install it?](#how-do-i-install-it)\n * [How do I use it?](#how-do-i-use-it)\n * [Why filter-repo instead of other alternatives?](#why-filter-repo-instead-of-other-alternatives)\n * [filter-branch](#filter-branch)\n * [BFG Repo Cleaner](#bfg-repo-cleaner)\n * [Simple example, with comparisons](#simple-example-with-comparisons)\n * [Solving this with filter-repo](#solving-this-with-filter-repo)\n * [Solving this with BFG Repo Cleaner](#solving-this-with-bfg-repo-cleaner)\n * [Solving this with filter-branch](#solving-this-with-filter-branch)\n * [Solving this with fast-export/fast-import](#solving-this-with-fast-exportfast-import)\n * [Design rationale behind filter-repo](#design-rationale-behind-filter-repo)\n * [How do I contribute?](#how-do-i-contribute)\n * [Is there a Code of Conduct?](#is-there-a-code-of-conduct)\n * [Upstream Improvements](#upstream-improvements)\n\n# Prerequisites",
"github_repo": "newren/git-filter-repo",
"github_stars": 12624,
"github_topics": [],
"homepage": "https://github.com/newren/git-filter-repo",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 8470,
"installs_365d": 79877,
"installs_90d": 24886,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "MIT",
"llm_generated_at": "2026-06-20T23:44:37+00:00",
"llm_model": "claude-haiku-4-5",
"name": "git-filter-repo",
"oldnames": [],
"one_liner": "Python tool for rapidly rewriting Git repository history with filtering, cleaning, and structural transformations.",
"optional_dependencies": [],
"rank_30d": 398,
"rank_365d": 494,
"rank_90d": 444,
"raw_hash": "2764e9cbde9b9d23",
"recommended_dependencies": [],
"revision": 0,
"ruby_source_path": "Formula/g/git-filter-repo.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [
"git",
"python"
],
"version_head": null,
"version_stable": "2.47.0",
"versioned_formulae": [],
"why_use_this": "Replaces the deprecated git filter-branch with much faster performance and broader capabilities for removing secrets, large files, sensitive data, or restructuring repos at scale. Includes a library API for building custom history-rewriting tools beyond simple command-line use. Official Git project recommendation over filter-branch."
}