GIT-SQUASH(1)

📦
version 7.5.0 · 7 versions
, in ubuntu stonking

✨ GIT-SQUASH — bestie edition ✨

okay so this is git-squash, part of the Git Extras crew 💖 it does one thing and it ATE: squash N last changes up to a ref'ed commit. iconic behaviour, truly.

🌸 NAME 🌸

git-squash — squash N last changes up to a ref'ed commit

🦋 SYNOPSIS 🦋

ngl bestie, the original page leaves this section completely blank — no synopsis line at all 💀 so we're just gonna vibe here and let the OPTIONS and EXAMPLES do the talking. scroll down, it's giving everything you need.

💅 DESCRIPTION 💅

So here's the tea 🫖: git-squash squashes the N last changes in your current branch. And what is N, you ask? N is literally the range of commits from the ref you hand it all the way up to HEAD. That's it. That's the whole job. main character energy, no notes.

✨ OPTIONS ✨

  • <source-branch> — the branch you wanna squash onto your current branch. sha..HEAD is what gets squashed, bestie. so everything from that sha up to HEAD? gone, merged, squashed, slay.
  • <--squash-msg> — commits the squash result using the concatenated messages of all the commits you squashed together 🎀 lowkey a little message-merging queen. but — and this is important — you can not use this one together with <commit-message>. pick a lane, bestie 😭
  • <commit-message> — if you give it a commit message, it commits the squashed result for you 🫶. if you don't, then the squash just stays chilling in the index — added but not committed. no commit, no problem, it's just sitting there waiting for you to do it yourself 💜

🔥 EXAMPLES 🔥

squash changes and follow up with a separate commit step

$ git squash my-other-branch
Updating a2740f5..533b19c
Fast-forward
Squash commit -- not updating HEAD
 my-changed-file | 1 +
 1 file changed, 1 insertion(+)
$ git commit -m "New commit without a real merge"

squash and commit with a given message

$ git squash HEAD~3 "Commit message"

squash and commit and concatenate all messages

$ git squash --squash-msg @~3

the --squash-msg one is the "I don't wanna write a message" move and honestly? valid 👑

💖 AUTHOR 💖

Written by Jesús Espino <jespinog@gmail.com> — thank you for your service, legend 🌈⭐

🙈 REPORTING BUGS 🙈

found a bug? don't suffer in silence bestie, go here:

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

we'll get it fixed, fr fr 💀🔧

👑 SEE ALSO 👑

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

that's the mothership, go explore 🦋🌸

⚠️ little heads up, bestie: <--squash-msg> and <commit-message> are mutually exclusive. the original says the one cannot be used together with the other. so don't come crying to me when you try both at once 😭

and that's the whole page!! this was Git Extras, page GIT-SQUASH(1), dated May 2026 — go squash something and make it look effortless 💅✨🎀 pookie out 🫶

📦 where this page comes from