GH-RUN-DOWNLOAD(1)

💅 GH-RUN-DOWNLOAD 💅

okay so bestie, welcome to the gh-run-download page from the GitHub CLI manual ✨ this one's a whole vibe, let's get into it 🫶

---

🌸 NAME 🌸

gh-run-download — download the artifacts your workflow run produced 🎀

---

✨ SYNOPSIS ✨

gh run download [<run-id>] [flags]

that's it, that's the whole incantation 💅

---

🦋 DESCRIPTION 🦋

So like, this command downloads the artifacts that a GitHub Actions workflow run generated 👑 grabbing your sweet sweet build outputs straight out of the run, fr fr.

The contents of each artifact get extracted under separate directories, and each directory is named after the artifact. Keyword: separate. But plot twist — if you only specify a single artifact, it gets extracted right into the current directory. The way that's such a main-character move 😭

By default (aka no flags in sight), this command downloads the latest artifact that was created and uploaded through GitHub Actions ⭐. But real talk: because workflows can delete or overwrite artifacts, you gotta use <run-id> to pick an artifact from a specific workflow run. 👀

---

💖 OPTIONS 💖

• -D, --dir <string> (default ".") — the directory you wanna download artifacts into 🍓
• -n, --name <stringArray> — download artifacts that match any of the given names ✨
• -p, --pattern <stringArray> — download artifacts that match a glob pattern 🦋

---

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

• -R, --repo <[HOST/]OWNER/REPO> — select a different repository using the [HOST/]OWNER/REPO format 🎀

---

💀 EXIT CODES 💀

Vibe-check your exit status, bestie:

• 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 💜

---

🧚 EXAMPLE 🧚 (yes it's singular, don't @ me)

# Download all artifacts generated by a workflow run
$ gh run download <run-id>

# Download a specific artifact within a run
$ gh run download <run-id> -n <name>

# Download specific artifacts across all runs in a repository
$ gh run download -n <name1> -n <name2>

# Select artifacts to download interactively
$ gh run download

that last one? no args at all? interactive selection era 🦋 literally iconic

---

🎀 SEE ALSO 🎀

• gh-run(1) — go read that one next, iykyk 💅

---

k bye bestie, go download some artifacts 🫶 this was GitHub CLI v2.102.0, dated Oct 2026 — written with love, shipped with the manual, and no cap ✨💖