GH-GIST-CREATE(1)              GitHub CLI manual             GH-GIST-CREATE(1)



NAME
       gh-gist-create - Create a new gist



SYNOPSIS
       gh gist create [<filename>... | <pattern>... | -] [flags]



DESCRIPTION
       Create a new GitHub gist with given contents.


       Gists can be created from one or multiple files. Alternatively, pass -
       as filename to read from standard input.


       By default, gists are secret; use --public to make publicly listed
       ones.



OPTIONS
       -d, --desc <string>
              A description for this gist


       -f, --filename <string>
              Provide a filename to be used when reading from standard input


       -p, --public
              List the gist publicly (default "secret")


       -w, --web
              Open the web browser with created gist



ALIASES
       gh gist new



EXIT CODES
       0: Successful execution


       1: Error


       2: Command canceled


       4: Authentication required


       NOTE: Specific commands may have additional exit codes. Refer to the
       command's help for more information.



EXAMPLE
       # Publish file 'hello.py' as a public gist
       $ gh gist create --public hello.py

       # Create a gist with a description
       $ gh gist create hello.py -d "my Hello-World program in Python"

       # Create a gist containing several files
       $ gh gist create hello.py world.py cool.txt

       # Create a gist containing several files using patterns
       $ gh gist create *.md *.txt artifact.*

       # Read from standard input to create a gist
       $ gh gist create -

       # Create a gist from output piped from another command
       $ cat cool.txt | gh gist create




SEE ALSO
       gh-gist(1)

                                   Aug 2025                  GH-GIST-CREATE(1)