gh-gist-create - Man Page
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
Referenced By
Mar 2025 GitHub CLI manual