REPO(1)

πŸ’… REPO(1) β€” the repo rebase manual, bestie edition

okay so this is the manual for repo rebase, from the Repo Manual. yes it's giving very "let me move your commits around while you watch" energy. let's go 🫢


✨ SYNOPSIS ✨

repo rebase {[<project>...] | -i <project>...}

so like... either you name a bunch of projects, or you go -i mode with exactly one. pick your fighter πŸ’–


🌸 DESCRIPTION 🌸

Summary

Rebase local branches on upstream branch. that's it, that's the whole vibe check. πŸ¦‹


πŸ‘‘ OPTIONS πŸ‘‘

  • -h, --help β€” show this help message and exit. the classic "wait what does this do again" button, no shame in it πŸ’…
  • --fail-fast β€” stop rebasing after first error is hit. one oopsie and we're OUT, no cap πŸ™ˆ
  • -f, --force-rebase β€” pass --force-rebase to git rebase
  • --no-ff β€” pass --no-ff to git rebase
  • --autosquash β€” pass --autosquash to git rebase
  • --whitespace=WS β€” pass --whitespace to git rebase. note the =WS, you gotta give it a value bestie, it's not optional πŸŽ€
  • --auto-stash β€” stash local modifications before starting. your messy little uncommitted edits get tucked away first ✨
  • -m, --onto-manifest β€” rebase onto the manifest version instead of upstream HEAD (this helps to make sure the local tree stays consistent if you previously synced to a manifest). lowkey the responsible choice if you synced to a manifest before 🌈

🌟 Logging options:

  • -v, --verbose β€” show all output. every last crumb, we love a chatty queen πŸ‘‘
  • -q, --quiet β€” only show errors. silent mode, main character energy, no commentary πŸ’œ
  • -i, --interactive β€” interactive rebase (single project only). literally read that parenthetical, it's one project only okay?? don't try it with a whole list 😭

🧚 Multi-manifest options:

  • --outer-manifest β€” operate starting at the outermost manifest
  • --no-outer-manifest β€” do not operate on outer manifests
  • --this-manifest-only β€” only operate on this (sub)manifest
  • --no-this-manifest-only, --all-manifests β€” operate on this manifest and its submanifests
Run repo help rebase to view the detailed manual. (yes there's a whole deep-dive version, go read it if you want the extended cut πŸ“)

πŸ”₯ DETAILS πŸ”₯

repo rebase uses git rebase to move local changes in the current topic branch to the HEAD of the upstream history, useful when you have made commits in a topic branch but need to incorporate new upstream changes "underneath" them.

so basically: you built your cute little tower of commits, upstream moved, and now you gotta slide your tower on top of the new stuff. it's giving "scoot over bestie" πŸ’…βœ¨


and that's the whole page!! πŸŽ€ this was repo rebase from the Repo Manual, dated June 2026. periodt, go rebase something πŸ’–

πŸ“¦ where this page comes from