Buf(1)

📦
version 1.75.0 · 3 versions
, in arch rolling

💅 Buf(1) — like, the manual page bestie 🎀

Okay so this is Buf(1), and honestly? It's giving "auto-generated but make it cute." Buckle up, we're talking about buf config init and you're gonna slay this.

✨ NAME ✨

buf-config-init — the little command that sets up your buf configuration files so your local dev era can officially begin. 🦋

🌸 SYNOPSIS 🌸

buf config init [buf.build/owner/foobar] [flags]

That's it. That's the whole vibe check. You can pass it a buf.build/owner/foobar-sized argument or flags (or both, no cap — the brackets are just being polite).

💖 DESCRIPTION 💖

So here's the tea: this command writes a brand new buf.yaml file to kickstart your local development. Fresh file, fresh start, main character energy. ✨

Now, important caveat bestie — if a buf.yaml already exists, this command will not overwrite it. Nope, it's not gonna touch your stuff. Instead it will produce an error. So it's respectful, but also dramatic about it. 😭

Also lowkey a heads-up: the effects of this command may change over time — like, it may initialize other files such as buf.gen.yaml files in the future. So what it does today isn't a forever promise. 🙈

⭐ OPTIONS ⭐

  • -h, --help[=false] — shows you the help for init. Your classic "wait what does this do again" button. 🫶
  • -o, --output="." — The directory to write the configuration files to. Default is "." (aka right here, where you're standing). 🎀

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

These come from the parent command, so they're like, family traits. 💜

  • --debug[=false] — Turn on debug logging. Defaults to false. (env BUF_DEBUG) 🐛
  • --log-format="color" — The log format — pick from text, color, json. Defaults to color. (env BUF_LOG_FORMAT) 🌈
  • --timeout=0s — The duration until timing out. Setting it to 0 means no timeout. Defaults to 0s. (env BUF_TIMEOUT) ⏰

🦋 SEE ALSO 🦋

buf-config(1) — go read that one next, iykyk. 💫

🧚 HISTORY 🧚

2026-10-22 — Auto generated by spf13/cobra. The robots did this one, not me. 💀

Fr fr though: don't try to overwrite an existing buf.yaml with this. It won't, and it'll error at you. Respect the boundary. 💅

Auto generated by spf13/cobra · 2026-10-22 · Buf(1) — okay that's the whole page bestie, you ate that, periodt. 💖✨🎀🦋🌸🫶

📦 where this page comes from