STG-PICK(1)

πŸ’… STG-PICK(1) β€” the StGit Manual, but make it group-chat ✨

okay so bestie, gather round 🫢 this is stg-pick, one of the little icons of the StGit suite, and it's literally here to help you yank patches from other branches (or straight-up commit objects) into your current series. no cap, it's giving main character energy πŸ‘‘


✨ NAME ✨

stg-pick β€” import a patch from another branch or a commit object πŸŽ€


🌸 SYNOPSIS 🌸

stg pick [OPTIONS] <source>...
stg pick [OPTIONS] [--name NAME] [--parent COMMITTISH] <source>
stg pick [OPTIONS] --fold [--file PATH]... <source>...
stg pick [OPTIONS] --update <source>...

πŸ¦‹ DESCRIPTION πŸ¦‹

So what does it do? It imports one or more patches from another branch or commit object into your current series πŸ’– that's the whole vibe.

By default, the imported patch's name is reused β€” like, it keeps its own name, iconic β€” but you can override it with the --name option if you're feeling ✨creative✨. And a commit object can be reverted with the --revert option, which is lowkey so useful.

When you're using the --expose option, the format of the commit message is determined by the stgit.pick.expose-format configuration option πŸ‘€ this option is a format string, exactly the kind you'd hand to the --pretty option of git-show(1). The default is:

format:%B%n(imported from commit %H)

which appends the commit hash of the picked commit to the patch's commit message. cute, right? πŸ₯°


πŸ’… OPTIONS πŸ’…

  • -B <branch>, --ref-branch=<branch> β€” pick patches from <branch> 🌿
  • -r, --revert β€” revert the given commit object, undoing its whole deal πŸ™ˆ
  • -x, --expose β€” append the imported commit id to the patch log πŸ“
  • --noapply β€” keep the imported patch unapplied (chill, it just sits there) πŸ’€
  • -n <name>, --name=<name> β€” use <name> for the patch name, your call bestie ✨
  • -p <committish>, --parent=<committish> β€” use <committish> as parent 🧬
  • --committer-date-is-author-date β€” instead of using the current time as the committer date, use the author date of the commit as the committer date. time travel, but make it git ⏰
  • --fold β€” fold the commit object into the current patch 🫢
  • --update β€” like fold, but only update the current patch's files πŸ‘‘
  • -f <path>, --file=<path> β€” only fold the given file (and yes, you may use this multiple times, go off) πŸ“

🌈 STGIT 🌈

Part of the StGit suite β€” see stg(1) πŸ’œ


fr fr, this whole page is from StGit 2.7.0, dated 10/17/2026 β€” slay, periodt πŸ’…βœ¨
πŸ“¦ where this page comes from