There is a Git command, filter-branch, which works wonders for changing the history of a repository, but it’s difficult to use because it forces you to know how Git works under the hood. Instead there is this little free tool, BFG Repo-Cleaner, which is intuitive, fast and recommended.
Check that there are some occurrences of your string
The first thing to do is to check that the repository contains the string you want to replace with another string. This will help later to make sure you effectively replaced it.
Notice that, on the above git log line, the -G option allows to specify a regular expression, and the -i option allows to ignore case.
Install BFG
BFG needs a JVM and you can install one with brew on a Mac.
Create search-replace.txt
BFG takes a file for specifying the text to search and replace. The accepted format is one replacement per line, like SEARCH==>REPLACE, with optional prefixes regex:, and glob:.
Use BFG
BFG acts on a bare repository which you can get by cloning with the --mirror option. Make sure the last commit doesn’t contains the text to be replaced, otherwise add a clean commit and push it before cloning.
Backup the old your-repository
You can recover this backup analogously to the section below.
Create a new your-repository
This step involves removing your remote old repository and creating a remote new one with the same name as before. Then you can push to it from your local repository using the --mirror option.
Check that your string was replaced by another string
If all is OK then you should see no results when searching again for your string but at least the same number of results you got when looking for it before if you now look for the replacement string.
Awesome, thank you.