REPO(1)

💖 REPO(1) — the Repo Manual, but make it a group chat 💖

okay bestie, pull up a chair 🪑 because this is the manual page for repo smartsync, from the Repo Manual, and we are gonna get you fluent. no cap.

---

✨ NAME ✨

repo — repo smartsync — manual page for repo smartsync

---

✨ SYNOPSIS ✨

repo smartsync [<project>...]

---

✨ DESCRIPTION ✨

🌸 Summary 🌸

Update working tree to the latest known good revision. that's it, that's the whole vibe. your tree, but fresh 💅

---

✨ OPTIONS ✨

• -h, --help — show this help message and exit. the "help me bestie" button 🫶
• -j JOBS, --jobs=JOBS — number of jobs to run in parallel (default: based on number of CPU cores). let your CPU cook 🔥
• --jobs-network=JOBS — number of network jobs to run in parallel (defaults to --jobs or 1). Ignored unless --no-interleaved is set. lowkey ignored unless you said --no-interleaved, iykyk
• --jobs-checkout=JOBS — number of local checkout jobs to run in parallel (defaults to --jobs or based on number of CPU cores). Ignored unless --no-interleaved is set. same deal, also ignored unless --no-interleaved ✨
• -f, --force-broken — obsolete option (to be deleted in the future). it's giving legacy. don't get attached 💀
• --fail-fast — stop syncing after first error is hit. one oopsie and we're DONE ✋
• --force-sync — overwrite an existing git directory if it needs to point to a different object directory. WARNING: this may cause loss of data. ⚠️ girl. be careful.
• --force-checkout — force checkout even if it results in throwing away uncommitted modifications. WARNING: this may cause loss of data. 😭 your uncommitted work does NOT survive this
• --force-remove-dirty — force remove projects with uncommitted modifications if projects no longer exist in the manifest. WARNING: this may cause loss of data. 💀 brutal but it's what it says
• --rebase — rebase local commits regardless of whether they are published. published? unpublished? doesn't care, rebasing anyway 💅
• -l, --local-only — only update working tree, don't fetch. stay home, no server gossip 🏠
• --no-manifest-update, --nmu — use the existing manifest checkout as-is. (do not update to the latest revision). freeze. do not perceive the latest revision 🙈
• --interleaved — fetch and checkout projects in parallel (default). the default behavior, main character energy 👑
• --no-interleaved — fetch and checkout projects in phases. phases, not parallel 🌀
• -n, --network-only — fetch only, don't update working tree. grab the goods, touch nothing 🎀
• -d, --detach — detach projects back to manifest revision. bye branch, hello detached ✌️
• -c, --current-branch — fetch only current branch from server. just the one, we're loyal 💜
• --no-current-branch — fetch all branches from server. all of them. greedy. obsessed 🌈
• -m NAME.xml, --manifest-name=NAME.xml — temporary manifest to use for this sync. temp manifest, temp vibe ⭐
• -g GROUP, --groups=GROUP — sync projects matching the specific groups. Not persistent unlike when used on init. it does NOT stick around like it does on init, fr fr
• --clone-bundle — enable use of /clone.bundle on HTTP/HTTPS. bundle szn 📦
• --no-clone-bundle — disable use of /clone.bundle on HTTP/HTTPS. no bundle, we're going raw 🚫
• -u MANIFEST_SERVER_USERNAME, --manifest-server-username=MANIFEST_SERVER_USERNAME — username to authenticate with the manifest server. who dis 🔑
• -p MANIFEST_SERVER_PASSWORD, --manifest-server-password=MANIFEST_SERVER_PASSWORD — password to authenticate with the manifest server. the secret 🤫
• --recurse-submodules — sync submodules from server. yes, down into the submodules 🕳️
• --no-recurse-submodules — don't sync submodules from server. nope, not going down there 🙅
• --use-superproject — use the manifest superproject to sync projects; implies -c. superproject mode, and it implies -c ✨
• --no-use-superproject — disable use of manifest superprojects. superproject cancelled 🚫
• --superproject-revision=SUPERPROJECT_REVISION — sync to superproject revision (applies to outer manifest). applies to the outer manifest, fyi 🦋
• --tags — fetch tags. tags girlie 🏷️
• --no-tags — don't fetch tags (default). the default, actually 🎀
• --optimized-fetch — only fetch projects fixed to sha1 if revision does not exist locally. if it's not here, then and only then 💅
• --retry-fetches=RETRY_FETCHES — number of times to retry fetches on transient errors. transient errors, we try again 🔁
• --prune — delete refs that no longer exist on the remote (default). cleanup szn, and it's the default 🧹
• --no-prune — do not delete refs that no longer exist on the remote. keep the ghosts 👻
• --auto-gc — run garbage collection on all synced projects. gc on EVERY synced project 🗑️
• --no-auto-gc — do not run garbage collection on any projects (default). the default, no gc for you 💤

🎀 Logging options 🎀

• -v, --verbose — show all output. all of it. every crumb 🍓
• -q, --quiet — only show errors. silence except when things break 🤫

🌈 Multi-manifest options 🌈

• --outer-manifest — operate starting at the outermost manifest. start at the very outside 🌀
• --no-outer-manifest — do not operate on outer manifests. not the outer ones, no 🙅
• --this-manifest-only — only operate on this (sub)manifest. this one. just this one 💅
• --no-this-manifest-only, --all-manifests — operate on this manifest and its submanifests. this one AND all its little submanifests 🫶

⭐ repo Version options ⭐

• --no-repo-verify — do not verify repo source code. skip the verification, live dangerously 💀

🦋 post-sync hooks 🦋

• --no-verify — Do not run the post-sync hook. no hook today 🚫
• --verify — Run the post-sync hook without prompting. run it, no questions asked ✨
• --ignore-hooks — Do not abort if post-sync hooks fail. if the hook flops, we carry on 😌

Run repo help smartsync to view the detailed manual. 👑

---

✨ DETAILS ✨

The repo smartsync command is a shortcut for sync -s. that's the tea ☕

---

and that's the whole page, bestie!! this was the repo smartsync manual, dated September 2026, from the REPO(1) section of the Repo Manual. you ate this. periodt 💅✨🎀🦋💖