GH-ISSUE-ARTIFACT-DOWNLOAD(1)

💅 gh-issue-artifact-download(1) — the GitHub CLI manual, bestie edition 🎀

Okay so real talk: this is the page for gh-issue-artifact-download, straight out of the GitHub CLI manual, and it's a preview feature (yes, that kind of preview, iykyk 👀). Grab a snack 🍓, we're downloading issue artifacts together.

---

✨ NAME ✨

gh-issue-artifact-download — download issue artifacts (preview) 🦋

---

🌸 SYNOPSIS 🌸

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

---

💖 DESCRIPTION 💖

So the whole vibe here is: you take issue artifacts and you download them into actual files on your machine. Iconic. 🙌

No artifact numbers? Cool, no problem — every artifact on that issue gets downloaded. Main character energy. 👑

You can also point at artifacts by their URLs instead of numbers — but heads up, all those URLs have to be on one single issue. No mixing and matching across issues, bestie, that's a whole different vibe check. And <issue> itself? That's either an issue number or an issue URL. Easy.

Now, the naming situation, because this matters:

• Each file gets named <number>-<name>
• Markdown docs end in .md
• HTML docs end in .html
• Links get saved as .url Internet Shortcut files 🔗

And here's the part where you have to pay attention, ngl: if a file already exists, that artifact fails 😭 — unless you come in with --clobber to overwrite it, or --skip-existing to just skip right past it. Choose your fighter. 💀

Where do the files go? That's your call:

• --dir picks the directory to download files into 📁
• --output picks the path for a single artifact
• --output - prints that artifact's content instead of writing a file 🖨️

And the time-travel option: use --version with a single artifact to grab an earlier version from its edit history. Literally going back in time, we love to see it. ⏳

---

⭐ OPTIONS ⭐

• --clobber — Overwrite existing files of the same name. Boom, gone, replaced. 🔥
• -D, --dir <directory> (default ".") — The directory to download files into. Defaults to the current directory, because of course it does.
• -O, --output <file> — The file to write a single artifact to (use "-" to write to standard output). One artifact, one path, that's the rule. 💅
• --skip-existing — Skip downloading when files of the same name exist. Not today, existing file. 🙈
• --version <number> (default 0) — Download the version with this number from the edit history. Default 0 means the current one, so you only flex this when you're feeling nostalgic. 🕰️

---

🔮 OPTIONS INHERITED FROM PARENT COMMANDS 🔮

• -R, --repo <[HOST/]OWNER/REPO> — Select another repository using the [HOST/]OWNER/REPO format. Yes, with the brackets, they're literal-ish, copy them right. 🫶

---

🚦 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. Don't come for me, come for the command's help. 💀

---

🌈 EXAMPLE 🌈

# Download every artifact on issue 142
$ gh issue artifact download 142

# Download two artifacts into a folder
$ gh issue artifact download 142 2 5 --dir notes

# Print one artifact's content
$ gh issue artifact download 142 2 --output -

# Download an earlier version of one artifact
$ gh issue artifact download 142 2 --version 5

Four examples, four vibes. Ate. 💅✨

---

🦋 SEE ALSO 🦋

• gh-issue-artifact(1) — the parent, the icon, the legend 👑

---

✿ and that's the whole page, bestie ✿ This was GitHub CLI 2.103.3, dated Oct 2026, and it's the GH-ISSUE-ARTIFACT-DOWNLOAD(1) page — now go download some artifacts, you gorgeous nerd 💜🎀✨