GH-WORKFLOW-LIST(1)

🦋 GH-WORKFLOW-LIST(1) 🦋

okay bestie, welcome to the GitHub CLI manual — specifically the page for gh-workflow-list, which is lowkey one of the most useful little commands in the whole toolkit. let's get into it 💅

---

✨ NAME ✨

gh-workflow-list — literally just: list workflows. that's it. that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

gh workflow list [flags]

---

💖 DESCRIPTION 💖

So here's the tea: gh workflow list lists your workflow files. and the little main-character twist? it hides disabled workflows by default — like, it's doing a vibe check and quietly filtering out the ones that aren't active. if you want the whole crew, you gotta ask for them (see --all below, iykyk) ✨

---

🫶 OPTIONS 🫶

• -a, --all — include the disabled workflows too, bestie. the whole roster, no exclusions, everybody's invited to the party 🎉
• -q, --jq <expression> — filter the JSON output using a jq expression. it's giving "give me exactly the fields I want and nothing else" 👑
• --json <fields> — output JSON with the specified fields. raw data, your rules 💅
• -L, --limit <int> (default 50) — maximum number of workflows to fetch. defaults to 50, so if you've got an absolute empire of workflows you might need to crank this up 🏰
• -t, --template <string> — format JSON output using a Go template; see gh help formatting. yes, that's a real thing, go read it, it's in the docs fr fr 🦋

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

• -R, --repo <[HOST/]OWNER/REPO> — select another repository using the [HOST/]OWNER/REPO format. very "I'm looking at a different repo today" of you 💜

---

🌈 ALIASES 🌈

gh workflow ls

yup — ls is the same thing. short, sweet, iconic. use whichever your fingers vibe with 🎀

---

⭐ JSON FIELDS ⭐

these are the fields you can ask for, exactly as written:

id, name, path, state

that's the whole list, no cap 🔥

---

💀 EXIT CODES 💀

so when the command dips out, here's what the numbers mean:

• 0: successful execution — slay, it worked ✨
• 1: error — something went sideways 😭
• 2: command canceled — you (or something) hit the brakes 🙈
• 4: authentication required — you gotta log in first, bestie 🔑

NOTE: specific commands may have additional exit codes. refer to the command's help for more information. so like, don't come for me if you see a number that isn't on this list — check the individual command's help 💅

---

🧚 SEE ALSO 🧚

• gh-workflow(1) — the parent, the origin story, the blueprint 🌸

---

and that's the whole page, bestie 🫶 mwah — this little icon was brought to you by GitHub CLI v2.102.0, dated Oct 2026, and the manual page name is GH-WORKFLOW-LIST(1). go list some workflows, you've got this 👑💖