GitHub Actions (deprecated)

This page documents the previous individual Buf GitHub Actions: buf-setup-action, buf-lint-action, buf-breaking-action, and buf-push-action. They’ve been superseded by the unified Buf Action (bufbuild/buf-action@v1), which combines setup, lint, format, breaking-change detection, push, and label archive into a single configuration.

The individual actions still work, but new development happens on buf-action. Migrate when convenient. For new setups, start with the Buf Action.

Migrate to the Buf Action

The unified Buf Action covers everything the four individual actions did, with a single workflow file and built-in conveniences (PR summary comments, label-based skip-breaking, automatic label archive on branch delete). For step-by-step migration instructions, see bufbuild/buf-action/MIGRATION.md.

Old action mapping

Individual action	Replacement in the unified Buf Action
bufbuild/buf-setup-action@v1	bufbuild/buf-action@v1 with setup_only: true
bufbuild/buf-lint-action@v1	lint step (default-on for pull requests)
bufbuild/buf-breaking-action@v1	breaking step (default-on for pull requests; skip with the buf skip breaking PR label)
bufbuild/buf-push-action@v1	push step (default-on for non-fork pushes; uses Git metadata automatically)

For the unified configuration surface, see Using the Buf GitHub Action.