GH-RUN-LIST(1)

✨ NAME ✨

gh-run-list — List recent workflow runs 💖

okay bestie, quick vibe check: this is the GitHub CLI manual page for GH-RUN-LIST(1), and it’s literally all about peeking at your recent workflow runs. 🎀

---

🌸 SYNOPSIS 🌸

gh run list [flags]

---

🦋 DESCRIPTION 🦋

List recent workflow runs. iconic behavior, no cap ✨

lowkey important note: if you provide the workflow_name to the -w flag, it will not fetch disabled workflows. so if you want disabled workflow runs too, also pass the -a flag and use the workflow_name with the -w flag. 🫶

another thing: runs created by organization and enterprise ruleset workflows will not display a workflow name due to GitHub API limitations. sad but true 😭

and if you’re trying to see runs associated with a pull request, you should run gh pr checks. periodt. 💅

---

💜 OPTIONS 💜

• -a, --all — include disabled workflows 🫶
• -b, --branch <string> — filter runs by branch 🌿
• -c, --commit <SHA> — filter runs by the SHA of the commit 🧚
• --created <date> — filter runs by the date it was created 📅
• -e, --event <event> — filter runs by which event triggered the run ⚡
• -q, --jq <expression> — filter JSON output using a jq expression 🔎
• --json <fields> — output JSON with the specified fields 🧾
• -L, --limit <int> (default 20) — maximum number of runs to fetch 🔥
• -s, --status <string> — filter runs by status: {queued|completed|in_progress|requested|waiting|pending|action_required|cancelled|failure|neutral|skipped|stale|startup_failure|success|timed_out} 👑
• -t, --template <string> — format JSON output using a Go template; see gh help formatting 🎀
• -u, --user <string> — filter runs by user who triggered the run 🙋
• -w, --workflow <string> — filter runs by workflow 🛠️

---

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

• -R, --repo <[HOST/]OWNER/REPO> — select another repository using the [HOST/]OWNER/REPO format 💖

---

⭐ ALIASES ⭐

gh run ls — yes bestie, it’s giving shortcut energy 💅

---

🍓 JSON FIELDS 🍓

attempt, conclusion, createdAt, databaseId, displayTitle, event, headBranch, headSha, name, number, startedAt, status, updatedAt, url, workflowDatabaseId, workflowName

---

💀 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. 📌

---

🧚 SEE ALSO 🧚

gh-run(1) — go click through and stay nosy, bestie 🫶

---

mwah 💋 this little manual moment is from GitHub CLI v2.102.0, dated Oct 2026 — now go slay those workflow runs, queen 👑✨