NAME

       git-reauthor - Rewrite history to change author´s identity

SYNOPSIS

       git reauthor [<options>]

DESCRIPTION

       Lets you replace the author and/or committer identities in commits and tags.

       The  command  goes  through all existing commits and tags in all local branches to selectively modify the
       identities present in those objects. All the other information such as dates, messages,.. are preserved.

       You can rewrite all the identities in the commits and tags objects by  using  the  --all  flag,  or  only
       replace  the  identities  whose email matches the value of the --old-email option. It is also possible to
       limit the rewrite to a certain type of identity: the author or the committer identity. By  default,  both
       of them are affected.
       For  each  of  those  identities  to  update, the command will replace the name and/or email with the new
       correct values as defined via the options. If the new identity name to set is not  defined,  the  current
       one will be kept (and vice-versa with the email).

       WARNING!  This  command  rewrites  history  and  as a result you will not able to push your branch to the
       remote without using the --force option.
       See more information with git help filter-branch.

OPTIONS

       -a, --all

           Rewrite ALL identities in commits and tags.

       -c, --use-config

           Define correct values from user Git config
           Values of --correct-email and --correct-name options take precedence over the ones from the config if specified as well

       -e, --correct-email <email>

           Define the correct email to set
           Empty email ´´ is allowed

       -n, --correct-name <name>

           Define the correct name to set
           Empty name ´´ is not allowed

       -o, --old-email <email>

           Rewrite identities matching old email in commits and tags
           Empty email ´´ is allowed

       -t, --type <id>

           Define the type of identities affected by the rewrite
           Possible type identifiers are: author, committer, both (default)

EXAMPLES

       Replace the personal email and name of Jack to his work ones

           $ git reauthor --old-email jack@perso.me --correct-email jack@work.com --correct-name ´Jack Foobar´

       Replace the email and name of Jack to the ones defined in the Git config

           $ git reauthor --old-email jack@perso.me --use-config

       Replace only the email of Jack (keep the name already used)

           $ git reauthor --old-email jack@perso --correct-email jack@perso.me

       Change only the committer email of Jack (keep the author email already used)

           $ git reauthor --old-email jack@perso.me --correct-email jack@work.com --type committer

       Change only the name and keep email to merge one user with multiple pseudonyms.

           $ git reauthor --old-email jack@perso.me --correct-name Jack

       Set Jack´s identity as the only one of the whole repository

           $ git reauthor --all --correct-email jack@perso.me --correct-name Jack

       Set Jack as the only committer of the whole repository (keeps authors)

           $ git reauthor --all --correct-email jack@perso.me --correct-name Jack --type committer

AUTHOR

       Written by Damien Tardy-Panis <mailto:damien@tardypad.me>

REPORTING BUGS

       <https://github.com/tj/git-extras/issues>

SEE ALSO

       <https://github.com/tj/git-extras>

                                                  December 2019                                  GIT-REAUTHOR(1)