GIT-SYNC(1)

💅 git-sync — bestie edition

okay so this is a page from the Git Extras manual, section 1, and it's all about git-sync. pull up a chair, we're doing this together 🫶

---

✨ NAME ✨

git-sync — sync ur local branch with the remote branch. that's it. that's the whole job. lowkey iconic. 💖

🌸 SYNOPSIS 🌸

git sync [--soft] [--force] [ <remote> <branch> ]

🦋 DESCRIPTION 🦋

so basically: it syncs ur local branch with <remote>/<branch>. match made in heaven fr fr.

when u don't say <remote> and <branch> on the command line, it just uses the upstream of ur local branch by default. it knows what u meant. main character energy. ✨

⚠️ bestie listen to me: tracked changes will be reset, and untracked files and directories will be removed — unless u add -s(--soft). the vibes here are "irreversible", so read that twice. 💀

🎀 OPTIONS 🎀

• --soft or -s — add this flag if u want to preserve untracked files and directories. she's protective. she's gentle. she's not deleting ur stuff. 🥺💖
• --force or -f — add this flag to disable interaction. no questions asked, no prompting, just vibes and motion. 🔥

🌈 EXAMPLES 🌈

sync local branch with its upstream — the classic, no notes:

$ git sync

sync local branch with origin/master — specifying who we're matching energies with:

$ git sync origin master

sync without cleaning untracked files — soft girl settings ON:

$ git sync -s origin master

sync without interaction — no talking, just doing:

$ git sync -f

👑 AUTHOR 👑

written by Takuma Yamaguchi <kumon0587@gmail.com>. a legend, an icon, and they were the moment. 🫶

💀 REPORTING BUGS 💀

found a bug?? not me finding bugs 😭 pls report them here, the group chat is always open:

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

🧚 SEE ALSO 🧚

more git-extras lore, the whole cinematic universe:

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

---

and that's the page, bestie 💜 authored by the Git Extras girlies, dated May 2026, and it's giving absolutely everything ✨💅🎀 ngl u ate this tutorial, no cap fr fr 🦋🌸