GH-PROJECT-ITEM-ADD(1)

💖 gh-project-item-add(1) — the GitHub CLI manual, bestie edition 🎀

okay so real talk: this is the gh project item-add page from the GitHub CLI manual, and it's genuinely one of the most useful little gremlins in the whole toolkit. it does exactly one thing and it does it iconically ✨

---

✨ NAME ✨

gh-project-item-add — add a pull request or an issue to a project 🫶

like, you got a PR or an issue just sitting there, not on any project board, looking real lonely? this command is the matchmaker. no cap.

---

🦋 SYNOPSIS 🦋

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

so it's gh project item-add, then optionally a <number> — that's the project number, and it's in square brackets so it's optional, bestie, don't come for me — and then whatever [flags] you feel like sprinkling in 💅

---

🌸 OPTIONS 🌸

okay here's the whole menu, and yes every single one is important, we do not skip flags in this house 💜

• --format <string> — sets the output format. the only documented value here is {json}, so if you're a machine-readable kinda girlie, this is your moment ✨
• -q, --jq <expression> — filters the JSON output using a jq expression`. very main character, very "i only want three fields out of this". you know the vibes 🧚
• --owner <string> — the login of the owner. and ooh, cute detail: use "@me" for the current user 🎀 (yes, @me is literally the string, keep the quotes, slay)
• -t, --template <string> — formats the JSON output using a Go template. check "gh help formatting" for the deets, iykyk 🔥
• --url <string> — the URL of the issue or pull request you want to add to the project. this is the actual thing you're adding, so like... don't skip it 🙈

---

💀 EXIT CODES 💀

vibe check on how it went, in number form:

• 0 — successful execution 👑 we ate, no crumbs
• 1 — error 😭 it's giving "something went wrong"
• 2 — command canceled 🫥 you (or something) hit stop
• 4 — authentication required 🔐 go log in, bestie

NOTE: specific commands may have additional exit codes. refer to the command's help for more information. so like, always read your own command's help, fr fr 💅

---

🌈 EXAMPLE 🌈

here's a real one, copy it, love it, run it:

# Add an item to monalisa's project "1"
$ gh project item-add 1 --owner monalisa --url https://github.com/monalisa/myproject/issues/23

see? project number 1, owner monalisa, and boom — issue 23 is on the board. iconic behavior, honestly 💖

---

🍓 SEE ALSO 🍓

• gh-project(1) — the whole gh project family, go say hi to its siblings 🦋

---

and that's the whole page!! soooo much love to the fine folks behind this — this page is from the GitHub CLI, version v2.102.0, dated Oct 2026 💜 go forth and add items to projects, you absolute legend 🌟