A powerful, production-grade CLI tool to safely rewrite Git commit authors and committers across your repository history.

• 🔄 Flexible Rewriting: Change specific authors or rewrite all commits
• 🔍 Author Detection: Identify all unique authors in your repository
• 🧪 Dry Run Mode: Preview changes before applying them
• 💾 Automatic Backups: Create repository backups before rewriting
• ⚡ Two Backends: Uses git filter-repo (preferred) with git filter-branch fallback
• 🛡️ Safety First: Validates repo state and provides clear warnings
• 📝 Preserves History: Keeps commit messages, timestamps, and commit order intact
• 🌍 Cross-Platform: Works on macOS, Linux, and Windows

pip install gitauth

git clone https://github.com/mubashardev/gitauth.git
cd gitauth
pip install -e .

For best performance, install git-filter-repo:

# macOS
brew install git-filter-repo

# Linux (Debian/Ubuntu)
sudo apt-get install git-filter-repo

# Or via pip
pip install git-filter-repo

If not installed, gitauth will automatically fall back to git filter-branch.

List all unique authors in your repository:

gitauth check

Output:

Found 3 unique authors:
  John Doe <[email protected]>
  Jane Smith <[email protected]>
  Old Name <[email protected]>

See which commits would be changed without modifying anything:

# Preview changes for a specific email
gitauth dry-run --old-email "[email protected]"

# Preview changes for a specific name
gitauth dry-run --old-name "Old Name"

Change commits from a specific author:

# By email
gitauth rewrite --old-email "[email protected]" --new-name "New Name" --new-email "[email protected]"

# By name
gitauth rewrite --old-name "Old Name" --new-name "New Name" --new-email "[email protected]"

# Both (more specific)
gitauth rewrite --old-email "[email protected]" --old-name "Old Name" --new-name "New Name" --new-email "[email protected]"

Change all commits to a new author:

gitauth rewrite --all --new-name "New Name" --new-email "[email protected]"

Manually create a backup of your repository:

gitauth backup

Creates: backup-YYYYMMDD-HHMMSS.tar.gz

After rewriting, push to remote (use with caution!):

# Interactive confirmation
gitauth push

# Force push without confirmation
gitauth push --force

Add --verbose to any command for detailed output:

gitauth rewrite --old-email "[email protected]" --new-name "New Name" --new-email "[email protected]" --verbose

Filter operations by specific branch:

# Check authors only on main branch
gitauth check --branch main

# Preview commits from specific branch
gitauth dry-run --old-email "[email protected]" --branch develop

# Interactive selection for a specific branch
gitauth dry-run --choose-old --branch feature/new-feature

Note: The --branch option filters which commits are analyzed and displayed. When using the rewrite command, git-filter-repo and git-filter-branch rewrite history across all branches by default (this is standard Git behavior for history rewriting tools).

Rewriting Git history is a destructive operation. Before using this tool:

1. ✅ Always create a backup (or work on a clone)
2. ✅ Coordinate with your team if working on a shared repository
3. ✅ Understand the implications of force-pushing
4. ✅ Test on a branch first before affecting main/master

After rewriting history, you'll need to force push:

git push --force-with-lease origin main
# or use: gitauth push --force

Warning: This will rewrite history on the remote. All collaborators must re-clone or reset their local repositories.

You accidentally committed with your work email and want to change it to personal:

# 1. Check current authors
gitauth check

# 2. Preview changes
gitauth dry-run --old-email "[email protected]"

# 3. Rewrite commits
gitauth rewrite --old-email "[email protected]" --new-name "Your Name" --new-email "[email protected]"

# 4. Push changes
gitauth push

You committed with different names/emails and want to unify them:

# Fix first identity
gitauth rewrite --old-email "[email protected]" --new-name "Your Name" --new-email "[email protected]"

# Fix second identity
gitauth rewrite --old-email "[email protected]" --new-name "Your Name" --new-email "[email protected]"

# Push once
gitauth push

Change all commits to a new author (e.g., transferring project ownership):

# Preview all commits
gitauth dry-run --all

# Rewrite all
gitauth rewrite --all --new-name "New Owner" --new-email "[email protected]"

# Push
gitauth push

1. Detection: Scans repository using git log to find commits matching criteria
2. Validation: Checks if repository is clean and valid
3. Backup: Optionally creates a compressed backup
4. Rewriting: Uses git filter-repo (fast) or git filter-branch (fallback)
5. Preservation: Maintains commit timestamps, messages, and tree structure
6. Safety: Provides dry-run mode and interactive confirmations

gitauth/
├── gitauth/
│   ├── __init__.py
│   ├── cli.py              # Typer CLI interface
│   └── core/
│       ├── __init__.py
│       ├── git_utils.py    # Git operations and validation
│       ├── detect.py       # Author detection
│       ├── backup.py       # Backup functionality
│       └── rewrite.py      # Rewrite logic (filter-repo/filter-branch)
├── tests/
│   ├── __init__.py
│   ├── test_git_utils.py
│   ├── test_detect.py
│   ├── test_backup.py
│   └── test_rewrite.py
├── pyproject.toml
├── README.md
└── LICENSE

git clone https://github.com/yourusername/gitauth.git
cd gitauth
pip install -e ".[dev]"

pytest
pytest --cov=gitauth tests/

black gitauth tests
ruff check gitauth tests

python -m build

python -m twine upload dist/*

• Python 3.8+
• Git 2.0+
• git-filter-repo (optional, recommended)

MIT License - see LICENSE file for details.

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Ensure all tests pass
5. Submit a pull request

• Initial release
• Support for git filter-repo and git filter-branch
• Dry run mode
• Automatic backups
• Author detection
• Cross-platform support

• 🐛 Report bugs
• 💡 Request features
• 📖 Read documentation

• Inspired by GitHub's author-rewrite script
• Powered by git-filter-repo
• Built with Typer

Made with ❤️ by Mubashar Dev