buf-lint(1)

buf-lint1

Run linting on protobuf files

Usage

buf lint [flags]

Overview

The first argument is the source, module, or Image to lint, which must be one of format [binpb,dir,git,json,mod,protofile,tar,txtpb,yaml,zip]. This defaults to "." if no argument is specified.

Options

--config=""
The buf.yaml file or data to use for configuration

--disable-symlinks[=false]
Do not follow symlinks when reading sources or configuration from the local filesystem By default, symlinks are followed in this CLI, but never followed on the Buf Schema Registry

--error-format="text"
The format for build errors or check violations printed to stdout. Must be one of [text,json,msvs,junit,github-actions,gitlab-code-quality,config-ignore-yaml]

--exclude-path=[]
Exclude specific files or directories, e.g. "proto/a/a.proto", "proto/a" If specified multiple times, the union is taken

-h, --help[=false]
help for lint

--path=[]
Limit to specific files or directories, e.g. "proto/a/a.proto", "proto/a" If specified multiple times, the union is taken

Options inherited from parent commands

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

History

2026-10-22 Auto generated by spf13/cobra

From buf 1.75.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.