.nh
.TH "Buf" "1" "2026-04-29" "Auto generated by spf13/cobra" ""

.SH NAME
buf-config-migrate - Migrate all buf.yaml, buf.work.yaml, buf.gen.yaml, and buf.lock files at the specified directories or paths to v2


.SH SYNOPSIS
\fBbuf config migrate [flags]\fP


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

.PP
The effects of this command may change over time


.SH OPTIONS
\fB--buf-gen-yaml\fP=[]
	The paths to the buf.gen.yaml generation templates to migrate

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

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for migrate

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

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


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--debug\fP[=false]
	Turn on debug logging

.PP
\fB--log-format\fP="color"
	The log format [text,color,json]

.PP
\fB--timeout\fP=0s
	The duration until timing out, setting it to 0 means no timeout


.SH SEE ALSO
\fBbuf-config(1)\fP


.SH HISTORY
2026-04-29 Auto generated by spf13/cobra