GH-GIST-CREATE(1)

🎀 gh-gist-create(1) — the GitHub CLI manual, bestie edition 🎀

okay so this is a page from the GitHub CLI manual and it's all about gh gist create, which is genuinely one of the most underrated little commands out here. let's get into it 💅

---

✨ NAME ✨

gh-gist-create — Create a new gist ✨

---

🦋 SYNOPSIS 🦋

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

like. look at that. filenames OR patterns OR a literal dash, plus flags. she contains multitudes 💖

---

🌸 DESCRIPTION 🌸

Create a new GitHub gist with whatever contents you feel like, honestly. main character energy.

Gists can be created from one or multiple files. alternatively — and this is the fun part — you can pass - as a filename to read from standard input. yes, that's a thing, and yes, it slaps 🫶

By default, gists are secret; use --public to make publicly listed ones. no cap, secret is the default, so if you wanted the world to see it you gotta say so.

---

💅 OPTIONS 💅

• -d, --desc <string> — a description for this gist ✍️
• -f, --filename <string> — provide a filename to be used when reading from standard input (aka the - situation — this is how you name the thing)
• -p, --public — list the gist publicly (default "secret") 👀
• -w, --web — open the web browser with the created gist 🌐

---

🧚 ALIASES 🧚

gh gist new

same vibe, different name. iykyk 💜

---

🔥 EXIT CODES 🔥

• 0 — Successful execution 🎉 slay
• 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, bestie — the vibes vary per command fr fr.

---

⭐ EXAMPLE ⭐

okay these are the moment, honestly:

# 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

the pattern one with *.md *.txt artifact.*?? ate. the pipe one?? iconic. use them. 🍓

---

🌈 SEE ALSO 🌈

• gh-gist(1) — the parent, the icon, the blueprint 👑

---

and that's the page!! this one's from GitHub CLI v2.102.0, dated Oct 2026 — go forth and gist, bestie, you're gonna do amazing 💖✨🎀