Buf(1)

💅 Buf(1) — like, the whole manual, bestie

okay so this is a page from the Buf(1) manual and honestly? it's a cute one. it's all about listing the commits in a policy, and by the end you're gonna know every flag on this thing. no cap. 🎀

---

✨ NAME ✨

buf-registry-policy-commit-list — list a policy's commits. that's it. that's the job. and it slays at it. 🦋

---

🌸 SYNOPSIS 🌸

buf registry policy commit list  [flags]

(yes there's literally a double space before [flags] in the real thing, iconic of them tbh, we keep it 💖)

---

🧚 DESCRIPTION 🧚

so here's the vibe: this command lists the commits inside a policy, and it does it based on the reference you specify. let's break it down because the details are everything:

• if you give it a commit reference, it lists that commit itself. one commit. that one. periodt. ✨
• if you give it a label reference, it lists the current and past commits associated with that label. like a lil history lesson. 📜
• if you specify no reference at all, it lists all the commits in this policy. the whole squad. the entire group chat. 👑

so like, the reference is basically the main character and the results are whatever it brings along. vibe check passed. 💅

---

🔥 OPTIONS 🔥

• --format="text" — the output format you wanna use. has to be one of [text,json]. pick your fighter, bestie. 💖
• -h, --help[=false] — help for list. the classic. when in doubt, ask for help and it shall provide. 🙈
• --page-size=10 — the page size. ten is the default, and ten is a perfectly respectable number of things to look at. ✨
• --page-token="" — the page token. here's the tea: if more results are available, a "next_page" key is present in the --format=json output. so like, that's your little breadcrumb to keep going. 🍓
• --reverse[=false] — reverse the results. by default they're ordered with the newest first, which is honestly correct behaviour, but if you're feeling chaotic, flip it. 🔄

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these ones come from the parent commands, so they're like the family hand-me-downs and they're all genuinely useful, ngl:

• --debug[=false] — turn on debug logging (env BUF_DEBUG). when things are acting up and you need to see everything. 🔍
• --log-format="color" — the log format text,color,json ⟨env BUF_LOG_FORMAT⟩. yes it defaults to color, because we like nice things. 🌈
• --timeout=0s — the duration until timing out. setting it to 0 means no timeout. zero means infinite patience, apparently. 😭

---

🦋 SEE ALSO 🦋

buf-registry-policy-commit(1) — go check out the parent, it's giving main character energy too. 💜

---

📜 HISTORY 📜

2026-10-22 — auto generated by spf13/cobra. not a human, not a vibe, just a generator doing its thing. 🤖

---

ngl bestie, the whole page is auto generated, so if something's weird, blame the machine, not me. 💀

---

and that's the whole thing! every flag, every default, every env var, all accounted for. you ate this. 🫶

this page? auto generated by spf13/cobra, dated 2026-10-22. we love a machine that ships. mwah 💋

okay bye bestie, go list some commits ✨💖🎀