Git CLI Tips
https://ohshitgit.com/
Hi there! You can get this same content without swears at dangitgit.com
Git is hard: screwing up is easy, and figuring out how to fix your mistakes is fucking impossible. Git documentation has this chicken and egg problem where you can’t search for how to get yourself out of a mess, unless you already know the name of the thing you need to know about in order to fix your problem.
So here are some bad situations I’ve gotten myself into, and how I eventually got myself out of them in plain english.
Oh shit, I did something terribly wrong, please tell me git has a magic time machine!?! git reflog
you will see a list of every thing you’ve
done in git, across all branches!
each one has an index HEAD@{index}
find the one before you broke everything
git reset HEAD@{index}
magic time machine
You can use this to get back stuff you accidentally deleted, or just to remove some stuff you tried that broke the repo, or to recover after a bad merge, or just to go back to a time when things actually worked. I use reflog A LOT. Mega hat tip to the many many many many many people who suggested adding it!
Oh shit, I committed and immediately realized I need to make one small change!
make your change
git add . # or add individual files git commit –amend –no-edit
now your last commit contains that change!
WARNING: never amend public commits
This usually happens to me if I commit, then run tests/linters… and FML, I didn’t put a space after an equals sign. You could also make the change as a new commit and then do rebase -i in order to squash them both together, but this is about a million times faster.
Warning: You should never amend commits that have been pushed up to a public/shared branch! Only amend commits that only exist in your local copy or you’re gonna have a bad time.
Oh shit, I need to change the message on my last commit! git commit –amend
follow prompts to change the commit message
Stupid commit message formatting requirements.
Oh shit, I accidentally committed something to master that should have been on a brand new branch!
create a new branch from the current state of master
git branch some-new-branch-name
remove the last commit from the master branch
git reset HEAD~ –hard git checkout some-new-branch-name
your commit lives in this branch now :)
Note: this doesn’t work if you’ve already pushed the commit to a public/shared branch, and if you tried other things first, you might need to git reset HEAD@{number-of-commits-back} instead of HEAD~. Infinite sadness. Also, many many many people suggested an awesome way to make this shorter that I didn’t know myself. Thank you all!
Oh shit, I accidentally committed to the wrong branch!
undo the last commit, but leave the changes available
git reset HEAD~ –soft git stash
move to the correct branch
git checkout name-of-the-correct-branch git stash pop git add . # or add individual files git commit -m “your message here”;
now your changes are on the correct branch
A lot of people have suggested using cherry-pick for this situation too, so take your pick on whatever one makes the most sense to you!
git checkout name-of-the-correct-branch
grab the last commit to master
git cherry-pick master
delete it from master
git checkout master git reset HEAD~ –hard Oh shit, I tried to run a diff but nothing happened?! If you know that you made changes to files, but diff is empty, you probably add-ed your files to staging and you need to use a special flag.
git diff –staged File under ¯_(ツ)_/¯ (yes, I know this is a feature, not a bug, but it’s fucking baffling and non-obvious the first time it happens to you!)
Oh shit, I need to undo a commit from like 5 commits ago!
find the commit you need to undo
git log
use the arrow keys to scroll up and down in history
once you’ve found your commit, save the hash
git revert [saved hash]
git will create a new commit that undoes that commit
follow prompts to edit the commit message
or just save and commit
Turns out you don’t have to track down and copy-paste the old file contents into the existing file in order to undo changes! If you committed a bug, you can undo the commit all in one go with revert.
You can also revert a single file instead of a full commit! But of course, in true git fashion, it’s a completely different set of fucking commands…
Oh shit, I need to undo my changes to a file!
find a hash for a commit before the file was changed
git log
use the arrow keys to scroll up and down in history
once you’ve found your commit, save the hash
git checkout [saved hash] – path/to/file
the old version of the file will be in your index
git commit -m “Wow, you don’t have to copy-paste to undo” When I finally figured this out it was HUGE. HUGE. H-U-G-E. But seriously though, on what fucking planet does checkout – make sense as the best way to undo a file? :shakes-fist-at-linus-torvalds:
Fuck this noise, I give up. cd .. sudo rm -r fucking-git-repo-dir git clone https://some.github.url/fucking-git-repo-dir.git cd fucking-git-repo-dir Thanks to Eric V. for this one. All complaints about the use of sudo in this joke can be directed to him.
For real though, if your branch is sooo borked that you need to reset the state of your repo to be the same as the remote repo in a “git-approved” way, try this, but beware these are destructive and unrecoverable actions!
get the lastest state of origin
git fetch origin git checkout master git reset –hard origin/master
delete untracked files and directories
git clean -d –force
repeat checkout/reset/clean for each borked branch
*Disclaimer: This site is not intended to be an exhaustive reference. And yes, there are other ways to do these same things with more theoretical purity or whatever, but I’ve come to these steps through trial and error and lots of swearing and table flipping, and I had this crazy idea to share them with a healthy dose of levity and profanity. Take it or leave it as you will!
Many thanks to everyone who has volunteered to translate the site into new languages, you rock! Björn Söderqvist (sv) · Moritz Stückler (de) · Daniil Golubev (ru) · Łukasz Wójcik (pl) · fedemcmac (it) · Michel (fr) · Andriy Sultanov (ua) · Meiko Hori (ja) · Alex Tzimas (gr) · Martijn ten Heuvel (nl) · Elad Leev (he) · Franco Fantini (es) · Catalina Focsa (ro) · Davi Alexandre (pt_BR) · Nemanja Vasić (sr) · Tao Jiayuan (zh) · Eduard Tomek (cs) · Ricky Gultom (id) · Khaja Md Sher E Alam (bn) · Rahul Dahal (ne) · Taha Paksu (tr) · Kitt Tientanopajai (th) · Gyeongjae Choi (ko) . With additional help from Iain Murray · Frank Taillandier · David Fyffe · Lucas Larson · Artem Vorotnikov
If you’d like to help add a translation into your language, submit a PR on GitHub
What’s your Oh shit, git moment? Share it with me! @ohshitgit @ksylor © 2016-2020 Katie Sylor-Miller