STG-UNCOMMIT(1)

💅 NAME 💅

okay bestie, welcome to STG-UNCOMMIT(1) from the StGit Manual 🫶

stg-uncommit — convert regular Git commits into StGit patches.

🦋 SYNOPSIS 🦋

stg uncommit <patchname-1> [<patchname-2> ...]
stg uncommit -n number [<patchname-prefix>]
stg uncommit -t <committish> [-x]

💖 DESCRIPTION 💖

so picture this: you’ve got one or more Git commits sitting at the base of your current stack, and stg uncommit turns them into StGit patches. The original Git commits are not modified — like, not even a little — and the StGit stack extends so those commits become the bottommost applied patches. It’s literally the opposite of stg-commit(1), iykyk. ✨

By default, the number of patches to uncommit is decided by how many patch names you give on the command line. The first provided name is used for the first patch to uncommit, i.e. for the newest patch. 🎀

The -n/--number option says how many patches to uncommit. When you use it, at most one patch name may be specified. That name is used as a prefix, and the patch number gets appended to it. If no patch names are provided on the command line, StGit automatically generates names based on the first lines of the commit messages. Cute, right? 💜

The -t/--to option means all commits up to and including the given commit should be uncommitted. The -x/--exclusive option may be used to exclude the "to" commit. 🌸

⚠️ only commits with exactly one parent can be uncommitted — in other words, merge commits may not be uncommitted. Not me inviting a merge commit to this party, because it cannot come. 💀

🎀 OPTIONS 🎀

• -n <number>, --number=<number> — uncommit the specified number of commits.
• -t <committish>, --to=<committish> — uncommit to the specified committish.
• -x, --exclusive — exclude the commit specified by the --to option.

👑 STGIT 👑

Part of the StGit suite — see stg(1).

---

mwah 💋 this page is from StGit 2.7.0, dated 10/17/2026. periodt. 🦋