# Installer buf avec Homebrew, apk, MacPorts, Nix, pacman, scoop, winget Consultez les chemins d'installation, exécutables, métadonnées et notes de sécurité de buf pour les workflows d'agents IA. ## installation ```sh sudo av install brew:buf ``` ## Réponse sur la sécurité des agents buf manages protobuf linting, generation, and registry workflows. - **Accès aux identifiants:** Reads registry tokens, environment variables, and project schema files. - **Modification distante:** Can push modules and interact with remote schema registries. - **Risque de publication ou d'artéfact:** Can publish schema modules and generated artifacts. - **Contrôle recommandé:** Gate push, registry login, and token-backed commands. - **Conseils d'utilisation par les agents:** Allow lint/generate; require approval for registry writes and token use. Commandes d'installation supplémentaires: ### macOS - Homebrew (100%): ```sh brew install buf ``` Preuve: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install buf ``` Preuve: 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 ``` Preuve: 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 ``` Preuve: 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 ``` Preuve: 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 ``` Preuve: 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 ``` Preuve: Windows Package Manager source index: bufbuild.buf from https://cdn.winget.microsoft.com/cache/source.msix ## Faits du paquet - **Clé du paquet:** brew:buf - **Gestionnaire de paquets:** Homebrew - **Page du gestionnaire de paquets:** - **Version:** 1.72.0 - **Résumé source:** New way of working with Protocol Buffers - **Page d'accueil:** - **Dépôt:** - **Docs amont:** - **Licence:** Apache-2.0 - **Archive source:** - **Dernière mise à jour:** 2026-07-26T10:56:35+02:00 - **Généré:** 2026-08-04T22:13:35+00:00 ## exécutables - buf (cli) - protoc-gen-buf-breaking (cli) - protoc-gen-buf-lint (cli) - buf (alias) - protoc-gen-buf-breaking (alias) - protoc-gen-buf-lint (alias) ## Dépendances de compilation - go ## Comportement d'installation - hook post-installation: non défini - Bouteille: disponible sur arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Version et fraîcheur - page générée: 2026-08-04 - version du gestionnaire: 1.72.0 - gestionnaire mis à jour: 2026-07-26 - données locales: OK - dépôt amont: https://github.com/bufbuild/buf - dernière version détectée: v1.72.0 (à jour) ## Historique du projet et usages Buf is a modern Protocol Buffers toolchain centered on the `buf` CLI, replacing many direct `protoc` workflows with module-aware builds, linting, breaking-change detection, formatting, code generation, dependency management, API calls, and access to the Buf Schema Registry. ### Historique du projet Buf was created by Buf Technologies as a developer-tooling layer for Protobuf projects. Its public repository presents it as a modern toolchain for Protobuf rather than a replacement for the schema language itself: it keeps the plugin model familiar to `protoc` users while adding workspace configuration, deterministic checks, and registry-aware workflows. The project grew beyond a formatter or wrapper into a broader ecosystem: the CLI, Buf Schema Registry, remote plugins, generated SDKs, ConnectRPC, Protobuf-ES, and Protovalidate are all positioned by Buf as related pieces of schema-driven API infrastructure. ### Historique d'adoption Buf adoption followed the pain points of larger Protobuf users: teams wanted one repeatable command for compiling, linting, compatibility checks, and generation instead of per-repository shell scripts around `protoc -I` paths. The CLI is distributed through Homebrew, npm, Docker, Windows installers, binary downloads, tarballs, source builds, and other package managers listed in the input. Registry features widened its role from local CLI tooling to organization-level schema governance. The Buf Schema Registry stores modules, renders documentation, resolves dependencies, hosts remote plugins, produces generated SDKs, and can enforce schema checks for teams that publish APIs there. ### Modes d'utilisation Typical CLI use starts with `buf config init`, then `buf build`, `buf format -w`, `buf lint`, `buf breaking --against ...`, and `buf generate`. Projects commonly check in `buf.yaml`, `buf.gen.yaml`, and `buf.lock` so CI and developer laptops run the same Protobuf workflow. Core CLI features work without a Buf Schema Registry account, while signing in adds private module dependency resolution, remote plugins, generated SDKs, hosted documentation, and server-side checks. ### Pourquoi les passionnés de paquets s'y intéressent Buf matters to package-tooling people because it treats `.proto` files as versioned modules instead of loose source files copied between repos. It brings package-lock and registry patterns familiar from language ecosystems into Protobuf schema distribution. It is also a notable example of a package manager formula that installs not only the main `buf` binary but companion protoc plugins, making Homebrew a convenient entry point for Protobuf linting and compatibility checks. ### Chronologie - 2020: Early public Buf releases established the CLI around Protobuf build, lint, breaking-change, and generation workflows. - 2021: Buf reached a stable v1 line and documented a no-breaking-changes-within-major-version CLI policy. - 2020s: The project expanded around the Buf Schema Registry, remote plugins, generated SDKs, ConnectRPC, Protobuf-ES, and Protovalidate. ### Related projects - `protoc` is the historical compiler that Buf augments for day-to-day Protobuf workflows. - The Buf Schema Registry is the hosted registry used for modules, documentation, remote plugins, generated SDKs, and schema checks. - ConnectRPC, Protobuf-ES, and Protovalidate are related Buf ecosystem projects named by the official README. ### Sources - - - - source_facts.package-manager ## Notes de sécurité narrow executable package without higher-risk signals. - **Risque Geiger:** vert / faible - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Credential files - Unix: ~/.netrc ## Détails de la base source - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** buf - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Autres enregistrements de gestionnaires de paquets - 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-r7: 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-r7: 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-r7: 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-r7: 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-r7: 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.72.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 ## Liens liés - [Terminal utility packages](https://pkg.so/fr/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://pkg.so/fr/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://pkg.so/fr/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [Networking and protocol packages](https://pkg.so/fr/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [go](https://pkg.so/fr/brew/go/) - Build dependency declared by Homebrew. - [protoc-gen-go](https://pkg.so/fr/brew/protoc-gen-go/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, protobuf. - [protoc-gen-grpc-web](https://pkg.so/fr/brew/protoc-gen-grpc-web/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, protobuf. - [protoc-gen-js](https://pkg.so/fr/brew/protoc-gen-js/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, protobuf. - [protoc-gen-grpc-swift](https://pkg.so/fr/brew/protoc-gen-grpc-swift/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, protobuf. - [protoc-gen-grpc-java](https://pkg.so/fr/brew/protoc-gen-grpc-java/) - Shares pkgdb curated category or tags: cli, code-generation, developer-tools, protobuf. - [protolint](https://pkg.so/fr/brew/protolint/) - Shares pkgdb curated category or tags: cli, developer-tools, linting, protobuf. - [buffrs](https://pkg.so/fr/brew/buffrs/) - Shares pkgdb curated category or tags: cli, developer-tools, protobuf. - [grpc](https://pkg.so/fr/brew/grpc/) - Shares pkgdb curated category or tags: api, cli, developer-tools, protobuf. - [buffa](https://pkg.so/fr/brew/buffa/) - Local package facts share a topical domain. Shared terms: buffers, cli, code, code-generation, developer. ## Combined YAML source View the package source record on GitHub. [combined/buf.yml](https://github.com/mxcl/pkgdb/blob/main/combined/buf.yml) ## Sources - pkg.so package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - pkgdb category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph - curated agent safety answer