GH-ISSUE-ARTIFACT-LIST(1)

📦 version 2.103.3, in nixos 26.05, nixpkgs unstable

💅 GH-ISSUE-ARTIFACT-LIST(1) — the GitHub CLI manual, bestie edition 🎀

okay so real talk: this is a page from the GitHub CLI manual (yes, that GitHub CLI), and it's all about listing the artifacts hanging out on an issue. buckle up 🦋

✨ NAME ✨

gh-issue-artifact-list — literally just lists artifacts on an issue (and it's in preview, so like… behave accordingly 🙈)

🌸 SYNOPSIS 🌸

gh issue artifact list {<issue-number> | <issue-url>} [flags]

you give it either an <issue-number> or an <issue-url>, plus whatever [flags] your heart desires 💖

🦋 DESCRIPTION 🦋

here's the vibe: this command lists the artifacts on an issue, and it does it in number order. every single artifact gets listed unless you go out of your way and set --limit. that's it, that's the whole plot 🫶

💅 OPTIONS 💅

  • -q, --jq <expression> — filter the JSON output with a jq expression. yes, the jq you know and love 😌
  • --json <fields> — spit out JSON with the fields you specify. you pick, it ships ✨
  • -L, --limit <int> (default 0) — max number of artifacts to fetch. default is 0, so by default you get everything — see above 👑
  • -t, --template <string> — format the JSON output with a Go template. for the deets, peep gh help formatting 📖
  • --type <string> — filter by type, and the type's gotta be one of: {generic|plan|link|embedded_html} 🔥

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • -R, --repo <[HOST/]OWNER/REPO> — pick a different repo using the [HOST/]OWNER/REPO format. inherited from the parent, still slays 💜

🎀 ALIASES 🎀

gh issue artifact ls

yup — ls is the short lil nickname, iykyk 🍓

⭐ JSON FIELDS ⭐

here's the whole field roster, no cap:

body, bodyHtml, createdAt, creator, description, id, name, number, type, updatedAt, updatedByActor, url

pick from these when you're doing the --json thing 💫

🧚 EXIT CODES 🧚

  • 0 — successful execution 🎉
  • 1 — error 😭
  • 2 — command canceled 💀
  • 4 — authentication required 🔐
NOTE: some specific commands may have additional exit codes, so like… check that command's help for more info, bestie 🫶

🔥 EXAMPLE 🔥

# List the artifacts on issue 142
$ gh issue artifact list 142

# List only links
$ gh issue artifact list 142 --type link

# Print artifact numbers and names as JSON
$ gh issue artifact list 142 --json number,name

obsessed with how clean that is, honestly 🌸

👑 SEE ALSO 👑

aaaaand that's the whole page, bestie 💖 this was GitHub CLI 2.103.3, dated Oct 2026 — no cap, that's the version and the date, go off 🎀✨🦋

📦 where this page comes from