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)