# Install buf

New way of working with Protocol Buffers. Version 1.70.0 via Homebrew; verified 2026-05-25.

## Install

```sh
sudo av install brew:buf
```

## Agent safety answer

buf manages protobuf linting, generation, and registry workflows.

- **Credential access:** Reads registry tokens, environment variables, and project schema files.
- **Remote mutation:** Can push modules and interact with remote schema registries.
- **Publish/artifact risk:** Can publish schema modules and generated artifacts.
- **Recommended control:** Gate push, registry login, and token-backed commands.
- **Agent-use guidance:** Allow lint/generate; require approval for registry writes and token use.

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install buf
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install buf
```

  Evidence: MacPorts ports tree: devel/buf/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add buf
```

  Evidence: Alpine Linux edge package indexes: buf from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#buf
```

  Evidence: nixpkgs package indexes: pkgs/by-name/bu/buf/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S buf
```

  Evidence: Arch Linux sync databases: buf from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

### Windows

- Scoop (92%):

```sh
scoop install main/buf
```

  Evidence: Scoop official bucket manifest trees: bucket/buf.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id bufbuild.buf -e
```

  Evidence: Windows Package Manager source index: bufbuild.buf from https://cdn.winget.microsoft.com/cache/source.msix

## Package Facts

- **Package key:** brew:buf
- **Package manager:** Homebrew
- **Package manager URL:** <https://formulae.brew.sh/formula/buf>
- **Version:** 1.70.0
- **Source summary:** New way of working with Protocol Buffers
- **Homepage:** <https://github.com/bufbuild/buf>
- **Repository:** <https://github.com/bufbuild/buf>
- **Upstream docs:** <https://buf.build/docs/cli>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/bufbuild/buf/archive/refs/tags/v1.70.0.tar.gz>
- **Last updated:** 2026-05-25T22:02:36Z
- **Generated:** 2026-06-10T07:18:26+00:00

## Executables

- buf (cli)
- protoc-gen-buf-breaking (cli)
- protoc-gen-buf-lint (cli)
- buf (alias)
- protoc-gen-buf-breaking (alias)
- protoc-gen-buf-lint (alias)

## Build Dependencies

- go

## Install Behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-06-10
- Package-manager version: 1.70.0
- Package-manager updated: 2026-05-25
- Local data status: ok
- Upstream repository: https://github.com/bufbuild/buf
- Upstream latest detected: v1.70.0 (current)

## Notes de sécurité

narrow executable package without higher-risk signals.

- **Protected-tool coverage:** Plain Text Buf Registry Token
- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** buf
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - buf: normalized package name match | nixpkgs package indexes: pkgs/by-name/bu/buf/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - buf - 1.59.0-r6: normalized package name match | Alpine Linux edge package indexes: buf from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | CLI to work with Protocol Buffers | https://buf.build/
- apk - buf-bash-completion - 1.59.0-r6: normalized package name match | Alpine Linux edge package indexes: buf-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Bash completions for buf | https://buf.build/
- apk - buf-fish-completion - 1.59.0-r6: normalized package name match | Alpine Linux edge package indexes: buf-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Fish completions for buf | https://buf.build/
- apk - buf-protoc-plugins - 1.59.0-r6: normalized package name match | Alpine Linux edge package indexes: buf-protoc-plugins from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | CLI to work with Protocol Buffers (protoc plugins) | https://buf.build/
- apk - buf-zsh-completion - 1.59.0-r6: normalized package name match | Alpine Linux edge package indexes: buf-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Zsh completions for buf | https://buf.build/
- pacman - buf - 1.70.0-1: normalized package name match | Arch Linux sync databases: buf from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A tool for working with Protocol Buffers | https://buf.build
- MacPorts - buf: normalized package name match | MacPorts ports tree: devel/buf/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/buf: normalized package name match | Scoop official bucket manifest trees: bucket/buf.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - bufbuild.buf: normalized package name match | Windows Package Manager source index: bufbuild.buf from https://cdn.winget.microsoft.com/cache/source.msix


## Related Links

- [Source-control packages](https://www.automicvault.com/fr/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/fr/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/fr/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/fr/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [go](https://www.automicvault.com/fr/pkg/brew/go/) - Build dependency declared by Homebrew.
- [protoc-gen-go](https://www.automicvault.com/fr/pkg/brew/protoc-gen-go/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, protobuf.
- [protoc-gen-grpc-web](https://www.automicvault.com/fr/pkg/brew/protoc-gen-grpc-web/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, protobuf.
- [protoc-gen-js](https://www.automicvault.com/fr/pkg/brew/protoc-gen-js/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, protobuf.
- [protoc-gen-grpc-swift](https://www.automicvault.com/fr/pkg/brew/protoc-gen-grpc-swift/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, protobuf.
- [protoc-gen-grpc-java](https://www.automicvault.com/fr/pkg/brew/protoc-gen-grpc-java/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, protobuf.
- [protolint](https://www.automicvault.com/fr/pkg/brew/protolint/) - Shares av.db curated category or tags: cli, developer-tools, linting, protobuf.
- [grpc](https://www.automicvault.com/fr/pkg/brew/grpc/) - Shares av.db curated category or tags: api, cli, developer-tools, protobuf.
- [protobuf-c](https://www.automicvault.com/fr/pkg/brew/protobuf-c/) - Shares av.db curated category or tags: cli, code-generation, developer-tools, protobuf.

## Sources

- Nucleus package database
- Geiger risk classifier
- secret-handling manifest
- local coverage README
- package-page enrichment
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
- curated agent safety answer
