GIT-RENAME-FILE(1)

💅 git-rename-file — the manual page, but make it cute

okay bestie, welcome to the git-rename-file glow-up guide ✨ this is part of the Git Extras situation, and she's honestly underrated.

---

✨ NAME ✨

git-rename-file — rename a file or directory and make sure Git actually notices, no matter how case-sensitive (or not) your filesystem is being that day 🫶

---

🌸 SYNOPSIS 🌸

git-rename-file OPTIONS source destination

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie: git-rename-file renames a file or a directory, and it guarantees Git recognizes the change, regardless of filesystem case-sensitivity. She's literally doing the job of mv and git mv at the same time — like, both. combined. one command. iconic behavior only 💅

and the moment you'll be obsessed: this is particularly useful when you wanna rename files or directories and the only thing changing is the case — because Git might straight up not detect that on case-insensitive filesystems 😭 like she just looks at myFile.txt and myfile.txt and goes "same thing, bestie, nothing to see here." rude. this command fixes that.

---

👑 OPTIONS 👑

• -h, --help — shows you the usage info. the classic "wait how do I do this" button 🎀

---

🌈 EXAMPLES 🌈

Rename a file, periodt:

git-rename-file old_filename new_filename

Rename a directory, same energy:

git-rename-file old_directory new_directory

---

💜 AUTHOR 💜

Written by Zachary Miller <codebyzach@gmail.com> — thank you for your service, king 🫡✨

---

🍓 REPORTING BUGS 🍓

found something cursed? spill it here, no gatekeeping:

https://github.com/tj/git-extras/issues

---

🧚 SEE ALSO 🧚

the whole git-extras cinematic universe lives at:

https://github.com/tj/git-extras

---

fr fr, go rename something with confidence. your filesystem case-sensitivity could NEVER dim your light 💖

---

okay that's the whole page, bestie 🎀 this was Git Extras, dated May 2026 — stay slay, keep your filenames exactly how you want 'em, and may your git status always be clean ✨💅🦋