git-mv

Rename a file

$ git mv [old-name.txt] [new-name.txt]

$ git mv [file.txt] [directory/]

$ git mv -f [source] [destination]

$ git mv -n [source] [destination]

git mv [options] source destination

git mv moves or renames files and directories while updating the Git index. It is equivalent to moving the file with `mv`, deleting the old path with `git rm`, and adding the new path with `git add`.
Using this command ensures the rename is properly staged for the next commit. While Git can detect renames automatically through content analysis, using `git mv` makes the intent explicit and updates the index in one step.

SOURCE

File or directory to move.

Target path or directory.

Force move/rename.

Skip errors.

Show what would happen.

Report moved files.

Display help information.

Actually a convenience wrapper. Git detects renames anyway. History follows content, not command.

git mv is a core Git command providing explicit rename/move tracking, though git can detect renames automatically through content analysis.

git-rm(1), git-add(1), mv(1)