GH-PROJECT(1)

🎀 gh-project — your GitHub Projects bestie 🎀

So this is the gh-project page from the GitHub CLI manual (yes, that manual, the GitHub CLI one 💅). Sit down, grab a strawberry drink 🍓, and let's get into it.

---

✨ NAME ✨

gh-project — work with GitHub Projects. That's the whole vibe.

---

🌸 SYNOPSIS 🌸

gh project <command> [flags]

---

🦋 DESCRIPTION 🦋

Work with GitHub Projects. Iconic. No notes. 👑

Okay so the important bit: the minimum required scope for your token is project. Literally the floor. You can verify your token scope by running gh auth status, and you add the project scope by running gh auth refresh -s project. Do that. Don't skip it. 🙈

---

💖 AVAILABLE COMMANDS 💖

Like, there are so many of them. Full roster, no cuts:

• gh-project-close(1) — close a project
• gh-project-copy(1) — copy a project
• gh-project-create(1) — create a project
• gh-project-delete(1) — delete a project
• gh-project-edit(1) — edit a project
• gh-project-field-create(1) — create a field in a project
• gh-project-field-delete(1) — delete a field in a project
• gh-project-field-list(1) — list the fields in a project
• gh-project-item-add(1) — add a pull request or an issue to a project
• gh-project-item-archive(1) — archive an item in a project
• gh-project-item-create(1) — create a draft issue item in a project
• gh-project-item-delete(1) — delete an item from a project by ID
• gh-project-item-edit(1) — edit an item in a project
• gh-project-item-list(1) — list the items in a project
• gh-project-link(1) — link a project to a repository or a team
• gh-project-list(1) — list the projects for an owner
• gh-project-mark-template(1) — mark a project as a template
• gh-project-unlink(1) — unlink a project from a repository or a team
• gh-project-view(1) — view a project

That's nineteen. Counted them. Obsessed. 🫶

---

🧚 EXIT CODES 🧚

So when the command finishes, here's what the numbers mean:

• 0 — successful execution (slay ✨)
• 1 — error 😭
• 2 — command canceled
• 4 — authentication required 🔐

NOTE: specific commands may have additional exit codes. Check that command's help for more info. iykyk 💅

---

🌈 EXAMPLE 🌈

Real examples, straight up:

$ gh project create --owner monalisa --title "Roadmap"
$ gh project view 1 --owner cli --web
$ gh project field-list 1 --owner cli
$ gh project item-list 1 --owner cli

Look at those. Beautiful. Main character commands. ⭐

---

💜 SEE ALSO 💜

• gh(1) — the parent, the blueprint, the blueprint-haver

---

Okay bestie that's the whole page 🎀 — this was GitHub CLI v2.102.0, dated Oct 2026, and you understood all of it, periodt. 💅🔥