GH-PROJECT-CLOSE(1)

πŸ’– gh-project-close β€” like, the moment you close a project ✨

okay bestie, so this is the GitHub CLI page for gh-project-close, and it does exactly one iconic thing: Close a project. That's it. That's the whole vibe. πŸŽ€


✨ SYNOPSIS ✨

gh project close [<number>] [flags]

so you can pass a <number>, but it's optional β€” the brackets said so, not me. 🫢


πŸ’… OPTIONS πŸ’…

  • --format <string> β€” sets the output format, and the only one on the menu rn is {json} πŸ’–
  • -q, --jq <expression> β€” filters that JSON output using a jq expression, iykyk πŸ”₯
  • --owner <string> β€” the login of the owner. pass "@me" to mean the current user, no cap ✨
  • -t, --template <string> β€” formats the JSON output using a Go template; peep gh help formatting for the deets πŸŽ€
  • --undo β€” flips the whole thing: Reopen a closed project πŸ¦‹ (not me bringing a project back from the dead πŸ’€)

🌈 EXIT CODES 🌈

like, so you know what happened when it's done:

  • 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. β€” so like, don't @ me if another command has extra ones, check its own help, fr fr πŸ’œ

🌸 EXAMPLE 🌸

closing a project, very demure, very mindful:

# Close project "1" owned by monalisa
$ gh project close 1 --owner monalisa

and here's the --undo moment where we bring it back to life:

# Reopen closed project "1" owned by github
$ gh project close 1 --owner github --undo

πŸ‘‘ SEE ALSO πŸ‘‘


k that's the whole page, mwah πŸ’‹ β€” this was the GitHub CLI v2.102.0 manual, dated Oct 2026, and yes it's giving main character energy. bye bestie! πŸ§šβ€β™€οΈβ­πŸ“

πŸ“¦ where this page comes from