buf-config-migrate(1)

buf-config-migrate1

Migrate all buf.yaml, buf.work.yaml, buf.gen.yaml, and buf.lock files at the specified directories or paths to v2

Usage

buf config migrate [flags]

Overview

If no flags are specified, the current directory is searched for buf.yamls, buf.work.yamls, and buf.gen.yamls.

The effects of this command may change over time

Options

--buf-gen-yaml=[]
The paths to the buf.gen.yaml generation templates to migrate

-d, --diff[=false]
Write a diff to stdout instead of migrating files on disk. Useful for performing a dry run.

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

--module=[]
The module directories to migrate. buf.yaml and buf.lock will be migrated

--workspace=[]
The workspace directories to migrate. buf.work.yaml, buf.yamls and buf.locks will be migrated

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.