GH-PROJECT-ITEM-CREATE(1)

πŸ’… gh-project-item-create πŸ’…

ok so bestie, welcome to the gh-project-item-create page from the GitHub CLI manual β€” yes that's the whole title, and yes you're gonna read it, because this little command is literally the moment you get to drop a draft issue into a project board without ever leaving your terminal. main character energy fr. πŸŽ€


✨ NAME ✨

gh-project-item-create β€” create a draft issue item in a project πŸ¦‹


✨ SYNOPSIS ✨

gh project item-create [<number>] [flags]

ok so the [<number>] is the project number, and it's in brackets so it's optional β€” the flags are where the real magic happens, iykyk ✨


✨ OPTIONS ✨

  • --body <string> β€” the body text for your draft issue. this is the content, the substance, the lore πŸ’–
  • --format <string> β€” output format. and the value is literally {json} β€” that's it, that's the one option. slay.
  • -q, --jq <expression> β€” filter that JSON output using a jq expression. obsessed, honestly β€” you get to slice and dice the response however you want πŸ”₯
  • --owner <string> β€” login of the owner. and here's the cute part: use "@me" for the current user 🫢 (yes, @me literally means you, go off)
  • -t, --template <string> β€” format JSON output using a Go template. also, heads up: see gh help formatting for the deets πŸ“–
  • --title <string> β€” title for the draft issue. give it a name, bestie, it deserves one πŸ‘‘

✨ EXIT CODES ✨

ok so when the command finishes, it tells you how it went with one of these numbers. vibe check time:

  • 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 β€” don't come for me, that's just what the page says πŸ’€

✨ EXAMPLE ✨

here's the whole thing in action, no cap:

# Create a draft issue in the current user's project "1"
$ gh project item-create 1 --owner "@me" --title "new item" --body "new item body"

look at that. project 1, owner @me, title "new item", body "new item body". confusing naming? maybe. iconic? absolutely ⭐


✨ SEE ALSO ✨

  • gh-project(1) β€” the big sibling page, go read it next πŸ’œ

and that's the whole page, bestie 🌈 it's giving GitHub CLI v2.102.0, dated Oct 2026 β€” mwah, go create some draft issues, you're gonna eat πŸ’…βœ¨πŸ“

πŸ“¦ where this page comes from