REPO(1)

💖 NAME 💖

repo — the repository management tool built on top of git, bestie. That's the whole vibe. This is the Repo Manual, and it's about to be your new roman empire. 🫶

---

✨ SYNOPSIS ✨

repo [-p|--paginate|--no-pager] COMMAND [ARGS]

So like. You give repo a COMMAND, you optionally hand it some ARGS, and you can pre-emptively settle the pager drama up front with -p/--paginate/--no-pager. That's it, that's the shape of it. 💅

---

🎀 OPTIONS 🎀

• -h, --help — shows this help message and then dips. exit(0) behavior, iconic.
• --help-all — same help message but it brings all the subcommands along too, then exits. the full tour, no skips.
• -p, --paginate — shows command output in the pager. cozy scrolling. 🦋
• --no-pager — turns the pager off. raw output, straight to your terminal, no middleman.
• --color=COLOR — controls how color gets used. your options are auto, always, never. pick your aesthetic. 🌈
• --trace — traces git command execution. equivalent to setting REPO_TRACE=1. peak detective energy 🔍
• --trace-to-stderr — the trace outputs go to stderr in addition to .repo/TRACE_FILE. two places, no waiting.
• --trace-python — traces python command execution. yes, the Python too.
• --time — time repo command execution. clocking it, literally. ⏱️
• --version — displays this version of repo. which one are you on, bestie?
• --show-toplevel — displays the path of the top-level directory of the repo client checkout. your home base. 🏠
• --event-log=EVENT_LOG — filename of the event log to append the timeline to. yes, a whole timeline, main character energy.
• --git-trace2-event-log=GIT_TRACE2_EVENT_LOG — directory to write the git trace2 event log to.
• --submanifest-path=REL_PATH — submanifest path. that's the whole thing, it's just the submanifest path.

---

🌸 The complete list of recognized repo commands is: 🌸

• abandon — Permanently abandon a development branch. note the word permanently, bestie, there is no undo button on this one 😭
• branch — view current topic branches. 👀
• branches — view current topic branches. (yes, same energy as branch, it's the plural twin, we love a duo)
• checkout — checkout a branch for development. go get your workspace.
• cherry-pick — cherry-pick a change.
• diff — show changes between commit and working tree. the receipts. 🧾
• diffmanifests — manifest diff utility.
• download — download and checkout a change.
• forall — run a shell command in each project. every single one. no skipping. 💀
• gc — cleaning up internal repo and Git state.
• grep — print lines matching a pattern.
• help — display detailed help on a command.
• info — get info on the manifest branch, current branch or unmerged branches. the tea ☕
• init — initialize a repo client checkout in the current directory.
• list — list projects and their associated directories.
• manifest — manifest inspection utility.
• overview — display overview of unmerged project branches.
• prune — prune (delete) already merged topics. bye girl 👋
• rebase — rebase local branches on upstream branch.
• selfupdate — update repo to the latest version. glow up time ✨
• smartsync — update working tree to the latest known good revision. emphasis on good.
• stage — stage file(s) for commit.
• start — start a new branch for development.
• status — show the working tree status.
• sync — update working tree to the latest revision.
• upload — upload changes for code review. send it 🚀
• version — display the version of repo.
• wipe — wipe projects from the worktree. destructive behavior, be so serious about this one

See 'repo help <command>' for more information on a specific command.

Bug reports: https://issues.gerritcodereview.com/issues/new?component=1370071

---

okay that's the whole page, you ate it, no crumbs 💅

this was repo, from the Repo Manual, and the version/date stamp on this whole thing is June 2026 — so if you're reading this from the future, hey bestie, you're right on time. 🎀🦋💜