Buf(1)

📦
version 1.75.0 · 3 versions
, in arch rolling

💅 BUF(1) — bestie's guide to buf stats 💅

okay so real talk, this is the manual page for Buf(1) — well, specifically the buf-stats corner of it — and by the end of this you're gonna be getting statistics like it's your whole personality. no cap. 🫶

✨ NAME ✨

buf-stats — get statistics for a given source or module 🌸

like, literally numbers about your protos. iconic behavior.

✨ SYNOPSIS ✨

buf stats  [flags]

that's it. that's the whole vibe check. 💅

✨ DESCRIPTION ✨

so the first argument is the source or module you wanna get statistics for, and it must be one of format [dir,git,mod,protofile,tar,zip] — those are your options, pick one, don't get creative 😭

if you pass no argument at all, it just defaults to ".". easy. lowkey generous of it, honestly. ✨

✨ OPTIONS ✨

okay here's the good part, the flags, the little knobs you get to fiddle with 🔥

  • --disable-symlinks[=false] — do not follow symlinks when reading sources or configuration from the local filesystem. but heads up bestie: by default, symlinks are followed in this CLI — just never followed on the Buf Schema Registry. so it's a whole different energy depending on where you are 🦋
  • --format="text" — the output format to use. must be one of [text,json]. that's the whole menu, no secret third option 🙈
  • -h, --help[=false] — help for stats. your little safety net 💖

✨ OPTIONS INHERITED FROM PARENT COMMANDS ✨

these ones you didn't even ask for, they just come with the parent command like a plus-one to the party 👑

  • --debug[=false] — turn on debug logging (env BUF_DEBUG) 🐛
  • --log-format="color" — the log format text,color,json ⟨env BUF_LOG_FORMAT⟩. yes those are the actual values, no i did not make them up ⭐
  • --timeout=0s — the duration until timing out; setting it to 0 means no timeout (env BUF_TIMEOUT). so 0 is the "we die like men" setting 💀

✨ SEE ALSO ✨

  • buf(1) — the main character, the parent, the whole reason we're here 👑

✨ HISTORY ✨

2026-10-22 — auto generated by spf13/cobra ✨

aaaand that's the page!! 🎀

sign-off time: this little masterpiece was auto generated by spf13/cobra, dated 2026-10-22 — same date, top and bottom, fr fr. so if anything here looks unhinged, blame the generator, not me 💜💅

go get those stats bestie, you're gonna slay 🦋🌈

📦 where this page comes from