Buf(1)

📦
version 1.75.0 · 3 versions
, in arch rolling

💅 Buf(1) — the buf registry plugin commit list glow-up

okay bestie, so this is a page out of the Buf manual (Buf(1), iykyk) and it's literally all about listing the commits of a registry plugin. pull up a chair, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

buf-registry-plugin-commit-list — as in, list plugins commits. that's the whole vibe. the way this command just... shows you commits. iconic. 👑

🦋 SYNOPSIS 🦋

buf registry plugin commit list  [flags]

literally that. flags are optional, slaying is mandatory. 💅

🌸 DESCRIPTION 🌸

so here's the tea ☕: this command lists the commits in a plugin, based on the reference you specify. and the reference you pick lowkey changes everything:

  • if it's a commit reference, it lists the commit itself — just the one, no extra drama.
  • if it's a label reference, it lists the current and past commits associated with that label. the whole friend group, basically. 🫶
  • and if you pass no reference at all? it lists all the commits in the plugin. main character energy, complete picture, we love to see it. ✨

no cap, that's the entire behaviour. let's get into the flags.

🎀 OPTIONS 🎀

  • --digest-changes-only[=false] — only shows the commits that have, like, actually changed digests. by default it's false, so all commits get listed. flip it if you only want the spicy ones. 🔥
  • --format="text" — the output format to use. has to be one of [text,json] — those are the only two options, bestie, no inventing a third one. default is text.
  • -h, --help[=false] — help for list. your little emergency contact when you forget a flag. 🙈
  • --page-size=10 — the page size. default is 10, so it's giving "one tidy lil page at a time". 📄
  • --page-token="" — the page token. and listen: if more results are available, there's a "next_page" key present in the --format=json output. that's your little breadcrumb to keep going. 🍞
  • --reverse[=false] — reverse the results. by default they're ordered with the newest first, so this flips the whole timeline around. ⏪

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

these aren't even this command's flags, they're heirlooms from the parent commands and you get them for free. generational wealth. 💜

  • --debug[=false] — turn on debug logging (env BUF_DEBUG). for when you need to see everything going on. 👀
  • --log-format="color" — the log format: text, color, json ⟨env BUF_LOG_FORMAT⟩. yes, those are the values, and yes, color is the default because aesthetics matter. 🌈
  • --timeout=0s — the duration until timing out. setting it to 0 means no timeout, which is either very brave or very chaotic of you. 😭

💖 SEE ALSO 💖

⭐ HISTORY ⭐

  • 2026-10-22 — Auto generated by spf13/cobra. the robots did this one, not me. 💀
ngl, pls don't forget: the --format=json output is where you'll spot that "next_page" key when there's more to see. page responsibly. 🎀

and that's the page, babe — written by Auto generated by spf13/cobra and dated 2026-10-22 in the footer, so like... thank the generator, not me. mwah. 💋✨🦋

📦 where this page comes from