Buf(1)

📦
version 1.75.0 · 3 versions
, in arch rolling

Buf(1) 💅

okay so bestie, welcome to the Buf manual page — the studio-agent edition ✨ this is a whole subcommand of the buf beta family, and honestly? it's giving main character energy. let's get into it 🎀

NAME 🦋

buf-beta-studio-agent — run an HTTP(S) server as the Studio agent, no cap 💖

SYNOPSIS ✨

buf beta studio-agent [flags]

DESCRIPTION 🌸

literally just: run an HTTP(S) server as the Studio agent. that's the whole vibe 🫶

OPTIONS 👑

  • --bind="127.0.0.1" — the address that gets exposed to accept HTTP requests, bestie. default is lowkey just localhost 💅
  • --ca-cert="" — the CA cert used in the client and server TLS configuration 🔒
  • --client-cert="" — the cert used in the client TLS configuration, periodt 🎀
  • --client-key="" — the key used in the client TLS configuration, ngl keep this safe 🙈
  • --disallowed-header=[] — the header names this agent disallows. when the agent receives an enveloped request with these headers set, it returns an error rather than forwarding the request to the target server — iconic behavior honestly 💀 multiple headers are appended if specified multiple times
  • --forward-header=[] — the headers to forward via the agent to the target server. must be an equals-sign-separated key-value pair, like --forward-header=fromHeader1=toHeader1 ✨ multiple header pairs are appended if specified multiple times
  • -h, --help[=false] — help for studio-agent, you know the drill 🫶
  • --origin="https://buf.build" — the allowed origin for CORS options, slay 💖
  • --port="8080" — the port exposed to accept HTTP requests 🌈
  • --private-network[=false] — use the agent with private network CORS, iykyk 🔥
  • --server-cert="" — the cert used in the server TLS configuration ⭐
  • --server-key="" — the key used in the server TLS configuration, protect it fr fr 🔐

OPTIONS INHERITED FROM PARENT COMMANDS 💜

these came from the parent command, so they're lowkey nepo babies but we love them anyway 🧚

  • --debug[=false] — turn on debug logging (env BUF_DEBUG) 🐛
  • --log-format="color" — the log format: text, color, json ⟨env BUF_LOG_FORMAT⟩ 🎨
  • --timeout=0s — the duration until timing out; setting it to 0 means no timeout (env BUF_TIMEOUT) ⏰

SEE ALSO 🌟

HISTORY 🕰️

  • 2026-10-22 — auto generated by spf13/cobra 🤖
reminder bestie: this whole page was auto generated by spf13/cobra on 2026-10-22, so blame the robot, not me 😭💖

okay that's the whole manual, you ate that 🍓 go forth and run your HTTP(S) server like the icon you are — mwah 💋✨

📦 where this page comes from