Buf(1)                                                                  Buf(1)



<?><?><?> (NAME)
       buf-format - <?><?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> buf



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       buf format  [flags]



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdout) <?><?><?><?><?>
       <?><?><?><?><?><?>.


       <?><?><?><?><?><?><?>:


       <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       (stdout):

       $ buf format


       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> -w <?><?><?><?><?><?><?><?> <?><?><?><?>:

       $ buf format -w


       <?><?><?><?><?> <?><?> diff <?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> -d:
       <?><?><?><?><?> <?><?> diff <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?>:

       $ buf format simple/simple.proto -d

       $ diff -u simple/simple.proto.orig simple/simple.proto
       --- simple/simple.proto.orig  2022-03-24 09:44:10.000000000 -0700
       +++ simple/simple.proto  2022-03-24 09:44:10.000000000 -0700
       @@ -2,8 +2,7 @@

       package simple;

       -
       message Object {
       -    string key = 1;
       -   bytes value = 2;
       +  string key = 1;
       +  bytes value = 2;
       }


       <?><?><?><?><?><?><?> <?><?> <?><?><?> --exit-code <?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?> diff:

       $ buf format --exit-code
       $ buf format -w --exit-code
       $ buf format -d --exit-code


       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdout):

       $ buf format simple/simple.proto

       syntax = "proto3";

       package simple;

       message Object {
         string key = 1;
         bytes value = 2;
       }


       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (stdout):

       $ buf format simple
       ...


       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (stdout):

       $ buf format buf.build/acme/petapis
       ...


       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> -o <?><?><?><?> <?><?><?><?>:


       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?>:

       $ buf format simple/simple.proto -o simple/simple.formatted.proto


       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>:

       $ buf format proto -o formatted


       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?>:

       $ buf format buf.build/acme/weather -o formatted


       <?><?><?><?><?><?><?><?> <?><?><?><?>(<?><?>) <?><?> <?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?> -w <?><?><?><?> <?><?><?><?>:


       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?>:

       $ buf format simple.proto -w


       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?>:

       $ buf format proto -w


       <?><?><?><?><?> diff <?> <?><?><?><?><?><?><?><?> <?><?><?><?>(<?><?>)
       <?><?> <?><?><?> <?><?><?>:

       $ buf format simple -d -w

       $ diff -u simple/simple.proto.orig simple/simple.proto
       ...


       <?><?><?><?><?><?><?> -w <?> -o <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.



<?><?><?><?><?><?><?><?> (OPTIONS)
       --config=""    <?><?><?><?> buf.yaml <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?>


       -d, --diff[=false]  <?><?><?><?><?> <?><?><?><?><?><?><?><?> (diff)
       <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>


       --disable-symlinks[=false]    <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> Buf Schema
       Registry <?><?><?><?><?> <?><?><?><?><?><?><?><?>


       --error-format="text"    <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> (stderr). <?><?><?><?> <?><?><?>
       <?><?> <?><?><?><?><?> [text,json,msvs,junit,github-actions,gitlab-
       code-quality] <?><?><?><?>


       --exclude-path=[]   <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> "proto/a/a.proto"<?> "proto/a" <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>


       --exit-code[=false]      <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>


       -h, --help[=false]  <?><?><?><?><?><?> <?><?><?><?> format


       -o, --output="-"    <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?> [dir,protofile]
       <?><?><?><?>. <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (stdout) <?><?><?><?><?>
       <?><?><?><?><?><?>


       --path=[]      <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> "proto/a/a.proto"<?> "proto/a" <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>


       -w, --write[=false]      <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?>



<?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> (OPTIONS INHERITED FROM PARENT
       COMMANDS)
       --debug[=false]     <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>


       --log-format="color"     <?><?><?><?> <?><?><?> <?><?><?><?><?>
       [text,color,json]


       --timeout=0s   <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> 0s <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>



<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       buf(1)



<?><?><?><?><?><?><?> (HISTORY)
       2026-07-17 <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> spf13/cobra

Auto generated by spf13/cobra     2026-07-17                            Buf(1)