PACKIT-SYNC-FROM-DOWNSTREAM(1)

💖 PACKIT-SYNC-FROM-DOWNSTREAM(1) 💖

okay bestie, welcome to the packit sync-from-downstream manual page — yes it's a whole page, and yes you're gonna read it, because it's genuinely useful and i refuse to let you rawdog this command without knowing what it does 🫶

---

✨ NAME ✨

packit-sync-from-downstream — copy synced files from Fedora dist-git… 💅

---

✨ SYNOPSIS ✨

packit sync-from-downstream [OPTIONS] [PATH_OR_URL]

---

✨ DESCRIPTION ✨

so what this does is: it copies synced files from Fedora dist-git back into upstream by opening a pull request. like, the files went downstream, and now we're bringing them home. it's giving ✨reverse uno✨.

the PATH_OR_URL argument is a local path or a URL to the upstream git repository, and no cap — if you don't pass anything, it just defaults to the current working directory. so if you're already standing in the repo, you can literally just run it and go 🧚

---

✨ OPTIONS ✨

• --dist-git-branch TEXT — a comma separated list of target branches in dist-git to sync from. if you don't say anything, it defaults to the repo's default branch. no stress 🌸
• --upstream-branch TEXT — the target branch in upstream to sync to. again, defaults to the repo's default branch if you stay quiet 💜
• --no-pr — do not create a pull request to the upstream repository. for when you want the files but not the whole "hey everyone look at my PR" moment 🙈
• --fork / --no-fork — push to a fork before creating a pull request. it's a toggle, so pick a side, bestie ⭐
• --remote-to-push TEXT — the name of the remote where packit should push. if this is not specified, it pushes to a fork if the repo can be forked. lowkey smart of it 💅
• -f, --force — don't discard changes in the git repo by default, unless this is set. so like, the discarding of your changes is not the default behaviour, and this flag flips it on. be careful, that's your work in there 😭
• -p, --package TEXT — the package to sync back, if more than one is available, like in a monorepo configuration. use it multiple times to select multiple packages. defaults to all the packages listed inside the config. so if you've got a monorepo situation, this is your girl 🔥
• -x, --exclude TEXT — a file to exclude from sync. not everything needs to come along for the ride, and that's valid 🎀

⚠️ heads up: --force changes whether your changes get discarded. read it twice, then read it again, then proceed. i'm serious, that's your git repo, not a vibe check 😭

---

🌈 that's the whole page 🌈

this lil manual is from packit 1.16.3, dated 2026-09-04, and it lives under the packit sync-from-downstream Manual umbrella. go forth and sync, bestie — you got this, fr fr 👑💖✨