GH-GIST-LIST(1)

💅 GH-GIST-LIST is literally your gist roster, bestie 🎀

okay so real talk: this is the gh gist list page from the GitHub CLI manual, and it's about to become your new favorite command. no cap.

✨ NAME ✨

gh-gist-list — List your gists. that's it, that's the whole vibe. 👑

🌸 SYNOPSIS 🌸

gh gist list [flags]

🦋 DESCRIPTION 🦋

List gists from your user account. all of them. your little gist children, lined up and accounted for 🫶

You can use a regular expression to filter the description, file names, or even the content of files in the gist using --filter. yes bestie, even the content — she's thorough like that 💅

For supported regular expression syntax, see ⟨https://pkg.go.dev/regexp/syntax⟩. go read it, it's giving homework but make it slay ✨

Use --include-content to include content of files, noting that this will be slower and increase the rate limit used. ⚠️ lowkey important: slower + more rate limit, so don't just leave it on 24/7 like it's a personality trait. Instead of printing a table, code will be printed with highlights similar to gh search code:

{{gist ID}} {{file name}}
    {{description}}
        {{matching lines from content}}

No highlights or other color is printed when output is redirected. so if you pipe it somewhere, the ✨aesthetic✨ stays home and you get plain text. respect honestly 🙈

💖 OPTIONS 💖

• --filter <expression> — Filter gists using a regular expression. regex girlies rise 🧚
• --include-content — Include gists' file content when filtering. more power, more slowness, more rate limit — you've been warned 💀
• -L, --limit <int> (default 10) — Maximum number of gists to fetch. default is 10, so don't act surprised when she stops at ten 🌸
• --public — Show only public gists. for the main character energy 👑
• --secret — Show only secret gists. for the mysterious era 🕵️‍♀️

🌈 ALIASES 🌈

gh gist ls

yep, ls works too — because sometimes you just wanna type less, and honestly? valid.

⭐ EXIT CODES ⭐

• 0: Successful execution. slay 💅
• 1: Error. it's giving ✨chaos✨ 😭
• 2: Command canceled. you pressed Ctrl+C, we all saw it.
• 4: Authentication required. go log in bestie, gh auth login is right there 🔑

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. so like, read the other help pages too, iykyk 🫶

🔥 EXAMPLE 🔥

# List all secret gists from your user account
$ gh gist list --secret

# Find all gists from your user account mentioning "octo" anywhere
$ gh gist list --filter octo --include-content

first one: all your secret gists. second one: anything mentioning octo anywhere, content included — she's searching everything, obsessed honestly 🍓

💜 SEE ALSO 💜

gh-gist(1) — go read the parent page, it's the whole gist universe 🌌

---

okay that's the whole page, bestie — and for the record, this was GitHub CLI v2.102.0, dated Oct 2026. mwah, go list some gists 💖✨🎀