Git's Filter Branch Command

FILTER BRANCH
Pruning And Separating Git Repository History

@matthewmccull
matthew@github.com
github.com/training
matthewmccullough

— Git Filter-Branch Man Page
Lets you rewrite git revision history by
rewriting the branches mentioned in the
<rev-list options>, applying custom
filters on each revision.
Those filters can modify each tree (e.g.
removing a file or running a perl rewrite
on all files) or information about each
commit.
Otherwise, all information (including
original commit times or merge
information) will be preserved.

Caution!
This re-creates new/diﬀerent hashes
for all modiﬁed commits.

Caution!
This is eﬀectively a new repository that
looks a lot like the old repository.

GIT_AUTHOR_NAME
GIT_AUTHOR_EMAIL
GIT_AUTHOR_DATE
GIT_COMMITTER_NAME
GIT_COMMITTER_EMAIL
GIT_COMMITTER_DATE

git ﬁlter-branch --env-ﬁlter 'export GIT_AUTHOR_NAME=Bonzo'

git filter-branch --tree-filter 'rm BADFILE' HEAD
git filter-branch --tree-filter 'rm BADFILE' master
git filter-branch --tree-filter 'rm BADFILE' otherbranch
git filter-branch --tree-filter 'find . -iname b -exec rm {} ;'

git ﬁlter-branch --index-ﬁlter 'git rm --cached --ignore-unmatch FILENAME' HEAD

git ﬁlter-branch --msg-ﬁlter '
sed -e "/^git-svn-id:/d"
'

git filter-branch --msg-filter '
cat &&
echo "Signed-off-by Matthew McCullough"
' HEAD~5..HEAD

Remove certain commits based on
commit contents

git ﬁlter-branch --subdirectory-ﬁlter OLD -- --all

Git's Filter Branch Command

More Related Content

Similar to Git's Filter Branch Command

More from Matthew McCullough

Recently uploaded

Git's Filter Branch Command