🍺 BREW Explorer

← all formulae

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.

Categories

Alternatives

git filter-branch BFG Repo Cleaner git-crypt
8.5k
30-day installs · #398
24.9k
90-day · #444
79.9k
365-day · #494
12.6k
★ GitHub stars · updated 8d ago

Links

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."
}