# Install git-filter-repo with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, scoop, zypper Quickly rewrite git repository history. Version 2.47.0 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:git-filter-repo ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install git-filter-repo ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install git-filter-repo ``` Evidence: MacPorts ports tree: devel/git-filter-repo/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add git-filter-repo ``` Evidence: Alpine Linux edge package indexes: git-filter-repo from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install git-filter-repo ``` Evidence: Debian stable package indexes: git-filter-repo from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install git-filter-repo ``` Evidence: Fedora Rawhide package metadata: git-filter-repo from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#git-filter-repo ``` Evidence: nixpkgs package indexes: git-filter-repo from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix - pacman (92%): ```sh sudo pacman -S git-filter-repo ``` Evidence: Arch Linux sync databases: git-filter-repo from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install git-filter-repo ``` Evidence: openSUSE Tumbleweed package metadata: git-filter-repo from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Scoop (92%): ```sh scoop install main/git-filter-repo ``` Evidence: Scoop official bucket manifest trees: bucket/git-filter-repo.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:git-filter-repo - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.47.0 - **Source summary:** Quickly rewrite git repository history - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - git-filter-repo (cli) - git-filter-repo (alias) ## Uses from macOS - git - python ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.47.0 - Local data: ok - Upstream repository: https://github.com/newren/git-filter-repo - info: No package-manager update timestamp was available. - info: No cached GitHub release or tag data was available. ## Project history and usage git-filter-repo is a Python-based Git history rewriting tool by Elijah Newren, positioned as a safer and faster successor to git filter-branch for repository cleanup, extraction, path rewriting, tag rewriting, and sensitive-data removal. ### Project history 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. ### Adoption history 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. ### How it is used 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. ### Why package nerds care 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. ### Timeline - 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. ### Sources - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** git-filter-repo - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Debian apt - git-filter-repo - 2.47.0-2: normalized package name match | Debian stable package indexes: git-filter-repo from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Quickly rewrite git repository history | https://github.com/newren/git-filter-repo - Nix - git-filter-repo: normalized package name match | nixpkgs package indexes: git-filter-repo from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix - Ubuntu apt - git-filter-repo - 2.38.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: git-filter-repo from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Quickly rewrite git repository history | https://github.com/newren/git-filter-repo - apk - git-filter-repo - 2.47.0-r2: normalized package name match | Alpine Linux edge package indexes: git-filter-repo from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | quickly rewrite git repository history | https://github.com/newren/git-filter-repo - apk - git-filter-repo-doc - 2.47.0-r2: normalized package name match | Alpine Linux edge package indexes: git-filter-repo-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | quickly rewrite git repository history (documentation) | https://github.com/newren/git-filter-repo - dnf - git-filter-repo - 2.47.0-10.fc45: normalized package name match | Fedora Rawhide package metadata: git-filter-repo from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Quickly rewrite git repository history (git-filter-branch replacement) | https://github.com/newren/git-filter-repo - pacman - git-filter-repo - 2.47.0-3: normalized package name match | Arch Linux sync databases: git-filter-repo from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Quickly rewrite git repository history (filter-branch replacement) | https://github.com/newren/git-filter-repo - zypper - git-filter-repo - 2.47.0-2.3: normalized package name match | openSUSE Tumbleweed package metadata: git-filter-repo from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Quickly rewrite git repository history (git-filter-branch replacement) | https://github.com/newren/git-filter-repo - MacPorts - git-filter-repo: normalized package name match | MacPorts ports tree: devel/git-filter-repo/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/git-filter-repo: normalized package name match | Scoop official bucket manifest trees: bucket/git-filter-repo.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [git-delete-merged-branches](https://www.automicvault.com/pkg/brew/git-delete-merged-branches/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extensions, version-control. - [git-delta](https://www.automicvault.com/pkg/brew/git-delta/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extensions, version-control. - [git-extras](https://www.automicvault.com/pkg/brew/git-extras/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extensions, version-control. - [git-flow](https://www.automicvault.com/pkg/brew/git-flow/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extensions, version-control. - [git-format-staged](https://www.automicvault.com/pkg/brew/git-format-staged/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extensions, version-control. - [git-fresh](https://www.automicvault.com/pkg/brew/git-fresh/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extensions, version-control. - [git-lfs](https://www.automicvault.com/pkg/brew/git-lfs/) - Shares av.db curated category or tags: cli, developer-tools, git, git-extensions, version-control. - [aicommit](https://www.automicvault.com/pkg/brew/aicommit/) - Shares av.db curated category or tags: cli, developer-tools, git, version-control. ## Combined YAML source View the package source record on GitHub. [combined/git-filter-repo.yml](https://github.com/automic-vault/db/blob/main/combined/git-filter-repo.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph