Cambiar la información del autor en Git

Cuando por algún motivo queramos cambiar el nombre o el email que están registrados en los commits de un repositorio Git (opens new window), será necesario reescribir todo el histórico del repositorio.

Una de las formas de hacerlo es con el comando filter-branch (opens new window) creado para la reescritura de ramas. Con él podemos definir un script que se encargará de reemplazas los nombres e emails antiguos por nuevos valores.

Es muy importante recalcar que estamos reescribiendo el histórico de nuestro repositorio por lo que este comando debe ser usado con extremo cuidado.

Como requisito previo a la ejecución del comando, debemos disponer del email del autor/confirmador (committer) que queremos reescribir, así como el nuevo email y usuario que queremos establecer.

El primer lugar debemos crear un nuevo clon temporal desde nuestra terminal (Mac/Linux) o Git Bash (Windows):

git clone --bare <repository-url>
cd <repository-folder>

A continuación ejecutamos el siguiente script, reemplazando previamente los valores de las variables ANTIGUO_EMAIL, NUEVO_USUARIO y NUEVO_EMAIL por nuestros datos:

git filter-branch --env-filter '

ANTIGUO_EMAIL="antiguo@email.com"
NUEVO_EMAIL="nuevo@email.com"
NUEVO_USUARIO="Nuevo Usuario"

if [ "$GIT_COMMITTER_EMAIL"="$ANTIGUO_EMAIL" ]
then
    export GIT_COMMITTER_EMAIL="$NUEVO_EMAIL"
    export GIT_COMMITTER_NAME="$NUEVO_USUARIO"
fi
if [ "$GIT_AUTHOR_EMAIL"="$ANTIGUO_EMAIL" ]
then
    export GIT_AUTHOR_EMAIL="$NUEVO_EMAIL"
    export GIT_AUTHOR_NAME="$NUEVO_USUARIO"
fi
' --tag-name-filter cat -- --branches --tags

Y finalmente publicamos el nuevo histórico al repositorio de origen:

git push --force --tags origin 'refs/heads/*'

Llegados a este punto, ya podemos eliminar el clon temporal que habíamos creado y comprobar en nuestro origen que el histórico ha sido actualizado.

---