---
name: "gh-gist-create"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-gist-create"
---

# gh-gist-create(1)

Create a new gist

## 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)](/gh-gist/1.md)**