GH-PROJECT-LIST(1)

✨ gh-project-list ✨

okay bestie, so this is the gh-project-list page from the GitHub CLI manual — the one that lists the projects for an owner 🎀

Basically: you wanna see somebody's projects? This is the lil command for that. Owner's projects, current user's projects, org projects, whatever — it's giving "organized queen" energy 💅

---

🌸 SYNOPSIS 🌸

gh project list [flags]

that's it. that's the whole shape of it. flags are where the fun lives, keep scrolling 🫶

---

💜 OPTIONS 💜

• --closed — include the closed projects too 🫣 by default they're not in the list, so this is you saying "no babe, show me the archived lore as well"
• --format <string> — pick your output format. the option is {json}, that's the one on the menu ✨
• -q, --jq <expression> — filter the JSON output with a jq expression. you give it the expression, it does the vibe check on your data 🔥
• -L, --limit <int> (default 30) — max number of projects to fetch. default is 30, so if you want more than thirty you gotta say so out loud, icon behavior 👑
• --owner <string> — the login of the owner. like, whose projects are we snooping through 🕵️‍♀️
• -t, --template <string> — format the JSON output using a Go template; see gh help formatting. yes it literally points you at another help page, go read it, iykyk 💀
• -w, --web — open the projects list in the browser instead 🦋 very "i'll deal with this in a GUI" of you, and honestly? valid

---

🎀 ALIASES 🎀

gh project ls

yep, ls works too, because typing the whole word is lowkey a lot sometimes 🍓

---

🌈 EXIT CODES 🌈

so when the command finishes, it tells you how it went:

• 0 — successful execution 💖 everything slayed, nothing to worry about
• 1 — error 😭 something went wrong
• 2 — command canceled 🙈 you (or something) backed out
• 4 — authentication required 🔐 like, 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 assume this list is the whole story for every command ever 💅

---

⭐ EXAMPLE ⭐

# List the current user's projects
$ gh project list

# List the projects for org github including closed projects
$ gh project list --owner github --closed

first one: your own projects, no owner needed, main character energy ⭐

second one: --owner github plus --closed, so you get the github org's projects and the closed ones. chef's kiss 🧚

---

🦋 SEE ALSO 🦋

• gh-project(1) — the parent page, go say hi 💜

---

okay that's the whole page!! mwah 💋

sign-off: this was GitHub CLI v2.102.0, dated Oct 2026 — that's the source/version and date, noted with love, periodt 🎀✨