---
name: "buf"
section: "1"
platform: "linux"
package: "buf"
version: "1.75.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/buf"
---

# buf(1)

The Buf CLI

## NAME

buf - The Buf CLI

## SYNOPSIS

**buf \[flags\]**

## DESCRIPTION

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

## OPTIONS

**--debug**\[=false\]\
 	Turn on debug logging (env BUF\_DEBUG)

**-h**, **--help**\[=false\]\
 	help for buf

**--help-tree**\[=false\]\
 	Print the entire sub-command tree

**--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)

**--version**\[=false\]\
 	Print the version

## SEE ALSO

**[buf-beta(1)](/buf-beta/1.md)**, **[buf-breaking(1)](/buf-breaking/1.md)**, **[buf-build(1)](/buf-build/1.md)**, **[buf-completion(1)](/buf-completion/1.md)**, **[buf-config(1)](/buf-config/1.md)**, **[buf-convert(1)](/buf-convert/1.md)**, **[buf-curl(1)](/buf-curl/1.md)**, **[buf-dep(1)](/buf-dep/1.md)**, **[buf-export(1)](/buf-export/1.md)**, **[buf-format(1)](/buf-format/1.md)**, **[buf-generate(1)](/buf-generate/1.md)**, **[buf-lint(1)](/buf-lint/1.md)**, **[buf-ls-files(1)](/buf-ls-files/1.md)**, **[buf-lsp(1)](/buf-lsp/1.md)**, **[buf-plugin(1)](/buf-plugin/1.md)**, **[buf-push(1)](/buf-push/1.md)**, **[buf-registry(1)](/buf-registry/1.md)**, **[buf-source(1)](/buf-source/1.md)**, **[buf-stats(1)](/buf-stats/1.md)**

## HISTORY

2026-10-22 Auto generated by spf13/cobra