GH-PROJECT-UNLINK(1)

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

okay so real talk, this is gh-project-unlink from the GitHub CLI manual, and it's literally the glow-up you need when a project is giving clingy energy and you wanna unlink it. No cap. 💅

---

✨ NAME ✨

gh-project-unlink — unlink a project from a repository or a team 🫶

Like, it's detachment season and the project is the one getting un-rostered. Not me being dramatic, it's just the facts. 💀

---

🌸 SYNOPSIS 🌸

gh project unlink [<number>] [flags]

so yeah, you got your optional <number> (that's the project number, main character energy ✨) and then your flags. That's the whole vibe check. 🦋

---

👑 OPTIONS 👑

• --owner <string> — the login of the owner, bestie. use "@me" if you're talking about the current user (yes, that's you, icon 💅).
• -R, --repo <string> — the repository that's getting unlinked from this project. bye boo 👋
• -T, --team <string> — the team that's getting unlinked</ph> from this project. also bye boo 👋

---

🚦 EXIT CODES 🚦

these are the receipts, ngl. the exit codes tell you how it went down:

1. 0 — successful execution ✨ slay, it worked, we ate.
1. 1 — error 😭 something went sideways.
1. 2 — command canceled 🙈 you (or something) hit the brakes.
1. 4 — authentication required 🔐 you gotta log in first, bestie, iykyk.

NOTE: specific commands may have additional exit codes. refer to the command's help for more information, fr fr. 📖

---

🧚 EXAMPLE 🧚

okay here's the part where it gets iconic. look at these:

# Unlink monalisa's project 1 from her repository "my_repo"
$ gh project unlink 1 --owner monalisa --repo my_repo

# Unlink monalisa's organization's project 1 from her team "my_team"
$ gh project unlink 1 --owner my_organization --team my_team

# Unlink monalisa's project 1 from the repository of current directory if neither --repo nor --team is specified
$ gh project unlink 1

see that last one? if you specify neither --repo nor --team, it just goes with the repository of the current directory. lowkey convenient, highkey iconic. ⭐

---

🌈 SEE ALSO 🌈

• gh-project(1) — the whole project family, go check it out 🫶

---

and that's the tea, bestie! 🍓 this was from the GitHub CLI v2.102.0, dated Oct 2026 — mwah, catch you in the next manpage 💜🎀