rewrite-authors

Rewrites author and committer names and emails across repositories.

Usage

git-wrangler rewrite-authors --name <new_name> --email <new_email> [--force] [--repo <repository_name>]

What it does

Iterates through Git repositories found in the current directory and its immediate subdirectories, and rewrites all author and committer information across the entire history using git-filter-repo. The remote origin URL is automatically restored after the rewrite.

Options

FlagRequiredDescription
--name <name>RequiredThe new name to set as author and committer.
--email <email>RequiredThe new email to set as author and committer.
--forceOptionalAllow rewriting even if the repository does not look like a fresh clone.
--repo <name>OptionalTarget a single repository instead of all in the current directory.

Prerequisites

  • git-filter-repo must be installed

Example

git-wrangler rewrite-authors --name "Jane Doe" --email "jane@example.com" --force

Notes

Warning: This rewrites Git history. You will need to force-push (git-wrangler push --force) to update all remotes.

  • The remote origin URL is preserved and restored automatically after the rewrite
  • --force is required when running on a non-fresh clone (which is the typical use case)