GH-RELEASE-LIST(1)

📦
version 2.102.0 · 13 versions
, in opensuse-leap 16.0

💖 gh-release-list — your lil' window into a repo's release history 💖

Okay bestie, so this is the gh-release-list page from the GitHub CLI manual — it's the one that shows you every release chillin' in a repository. Think of it as the group chat scrollback for all your versions. Let's get into it 🫶

🌸 NAME 🌸

gh-release-list — literally just lists the releases in a repository. That's the whole gig. Iconic, honestly.

✨ SYNOPSIS ✨

gh release list [flags]

💅 OPTIONS 💅

  • --exclude-drafts — ngl, this one filters out the draft releases. You know, the ones that aren't ready yet. Bye 👋
  • --exclude-pre-releases — same energy but for pre-releases — hides 'em from your list ✨
  • -q, --jq _<expression>_ — filter the JSON output using a jq expression. Chef's kiss for when raw JSON is too much 💅
  • --json _<fields>_ — spit out JSON with the specific fields you asked for
  • -L, --limit _<int>_ (default 30) — the max number of items to fetch. Thirty by default, bestie, that's the vibe 💖
  • -O, --order _<string>_ (default "desc") — the order releases come back in. Your options are {asc|desc} — ascending or descending, pick your fighter ⭐
  • -t, --template _<string>_ — format the JSON output using a Go template. See gh help formatting for the deets 🎀

🧚 OPTIONS INHERITED FROM PARENT COMMANDS 🧚

  • -R, --repo _<[HOST/]OWNER/REPO>_ — select a different repository using the [HOST/]OWNER/REPO format. Handy when you're snooping on someone else's releases 👀

🦋 ALIASES 🦋

gh release ls

Yeah, ls works too — because we're all just shell gremlins at heart 💀

🌈 JSON FIELDS 🌈

The fields you can ask for are:

createdAt, isDraft, isImmutable, isLatest, isPrerelease, name, publishedAt, tagName

That's the whole menu — order it however you like 🍓

🔥 EXIT CODES 🔥

  • 0 — Successful execution. We ate and left no crumbs 👑
  • 1 — Error. It's giving... not great 😭
  • 2 — Command canceled
  • 4 — Authentication required. Log in, bestie 💜
NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. So like, always double-check if something weird happens, iykyk 🙈

🎀 SEE ALSO 🎀

  • gh-release(1) — the parent command, the main character energy this whole thing lives under ✨

Anyway bestie, that's the whole page — every flag, every field, every exit code, no cap. Go forth and list those releases, you gorgeous Unix gremlin 💖

This cutie was brought to you by GitHub CLI v2.102.0, dated Oct 2026, and yes it's the GH-RELEASE-LIST(1) manual page — slay 🦋

📦 where this page comes from