GH-PROJECT-CREATE(1)

πŸ’… GH-PROJECT-CREATE(1) β€” the GitHub CLI manual, bestie edition πŸŽ€

okay so real quick before we dive in: this is a page straight out of the GitHub CLI manual, and it's literally the glow-up guide for making a brand-new project. no cap, it's a short one. let's go ✨


🌸 NAME 🌸

gh-project-create β€” create a project. that's it. that's the whole vibe. you're making a project, bestie πŸ’–


✨ SYNOPSIS ✨

gh project create [flags]

short, sweet, iconic. flags only β€” no positional arguments doing main character stuff here 🫢


πŸ”₯ OPTIONS πŸ”₯

okay so here's the whole flag lineup, and yes i'm listing every single one because we don't skip πŸ’…

  • --format <string> β€” picks how the output gets formatted. the only value it knows is {json}, so that's your one (1) option, bestie πŸ“
  • -q, --jq <expression> β€” filters the JSON output using a jq expression. it's giving "i only want part of the JSON, not the whole thing" ✨
  • --owner <string> β€” the login of the owner. and here's the cute part: use "@me" for the current user, so you don't have to remember your own username, lowkey genius 🧚
  • -t, --template <string> β€” formats the JSON output using a Go template. and the docs say to go see "gh help formatting" for the deets β€” iykyk πŸ“–
  • --title <string> β€” the title for the project. give it a name, give it a personality πŸ‘‘

πŸ’€ EXIT CODES πŸ’€

these are the numbers you get when the command dips out. memorize them or at least vibe-check them:

  • 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 @ me if you see a number that isn't on this list, check that command's own help fr fr πŸ’€

🌈 EXAMPLE 🌈

here's the moment you've been waiting for β€” an actual real-life usage:

# Create a new project owned by login monalisa
$ gh project create --owner monalisa --title "a new project"

see how it's done? owner goes in --owner, title goes in --title, and boom πŸ’₯ β€” a new project. monalisa ate that 🎨


πŸ¦‹ SEE ALSO πŸ¦‹

  • gh-project(1) β€” the parent page, the main character of the project universe. go read it next πŸ‘‘

and that's the whole page, bestie!! no crumbs left behind πŸ’œ

mwah πŸ’‹ β€” brought to you by GitHub CLI v2.102.0, dated Oct 2026. go forth and create projects, you gorgeous nerd 🫢✨

πŸ“¦ where this page comes from