OS Manuals

/usr/bin/buf

A new way of working with Protocol Buffers.

From buf 1.75.0-r0 (os), captured 2026-11-05 by running buf --help (exit 0). permalink

The Buf CLI

A tool for working with Protocol Buffers and managing resources on the Buf Schema Registry (BSR)

Usage:
  buf [flags]
  buf [command]

Available Commands:
  beta        Beta commands. Unstable and likely to change
  breaking    Verify no breaking changes have been made
  build       Build Protobuf files into a Buf image
  completion  Generate auto-completion scripts for commonly used shells
  config      Work with configuration files
  convert     Convert a message between binary, text, or JSON
  curl        Invoke an RPC endpoint, a la 'cURL'
  dep         Work with dependencies
  export      Export proto files from one location to another
  format      Format Protobuf files
  generate    Generate code with protoc plugins
  help        Help about any command
  lint        Run linting on Protobuf files
  ls-files    List Protobuf files
  lsp         Work with Buf Language Server
  plugin      Work with check plugins
  push        Push to a registry
  registry    Manage assets on the Buf Schema Registry
  source      Work with Protobuf source files
  stats       Get statistics for a given source or module

Flags:
      --debug               Turn on debug logging (env BUF_DEBUG)
  -h, --help                help for buf
      --help-tree           Print the entire sub-command tree
      --log-format string   The log format [text,color,json] (env BUF_LOG_FORMAT) (default "color")
      --timeout duration    The duration until timing out, setting it to 0 means no timeout (env BUF_TIMEOUT)
      --version             Print the version

Use "buf [command] --help" for more information about a command.
Options (6)
OptionDescriptionSource
--debugTurn on debug logging (env BUF_DEBUG)help
-h, --helphelp for bufhelp
--help-treePrint the entire sub-command treehelp
--log-format stringThe log format [text,color,json] (env BUF_LOG_FORMAT) (default "color")help
--timeout durationThe duration until timing out, setting it to 0 means no timeout (env BUF_TIMEOUT)help
--versionPrint the versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.