This package is abandoned and no longer maintained. The author suggests using the concretecms/incremental-filter-branch package instead.

Shell script to call git filter-branch in an incremental way

1.0.2 2018-03-21 11:27 UTC

This package is auto-updated.

Last update: 2022-05-19 18:24:04 UTC


TravisCI Build Status


git filter-branch is a really nice git feature. For instance, it allows fancy stuff like subtree-splitting.

Problems may arise when the repository contains a lot of commits: this operation can take a lot of time.

Luckily recent versions of git allow us to perform this operation in an incremental way: the first time filter-branch still requires some time, but following calls can be very fast.


  • git 2.16.0 or newer
  • common commands (sed, grep, md5sum, cut, ...)


Get the script and read the syntax using the --help option.


./bin/incremental-git-filterbranch \
    --branch-whitelist 'develop master rx:release\/.*' \
    --tag-blacklist 'rx:5\..*' \
    --tags-plan all --tags-max-history-lookup 10 \ \
    '--prune-empty --subdirectory-filter concrete' \

Legal stuff

Use at your own risk. MIT License.


Special thanks to Ian Campbell for the implementation of the --state-branch option of git, and his hints about how it can be used. This script works only thanks to him (and if it doesn't work I'm the only person to blame).