Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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  com-
     mand'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 2026		       GH-GIST-CREATE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-gist-create&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help