GH-PROJECT-LINK(1)

💅 GH-PROJECT-LINK — like, the manual page bestie

okay so this is the gh-project-link page from the GitHub CLI manual — it's the lil command that links a project to a repository or a team 🎀 and honestly? it's giving connector energy, it's giving "let me introduce these two" ✨

---

🦋 NAME 🦋

gh-project-link — link a project to a repository or a team 🫶

---

🌸 SYNOPSIS 🌸

gh project link [<number>] [flags]

so yeah, you pass an optional project number, plus whatever flags your heart desires, and boom — linked 🔥

---

✨ OPTIONS ✨

• --owner <string> — the login of the owner, bestie 💖. Wanna rep yourself? use "@me" for the current user, slay 👑
• -R, --repo <string> — the repository that's gonna get linked to this project 🌈 this is the repo-side of the situationship
• -T, --team <string> — the team you wanna link to this project 🦋 team-side, no cap

---

💀 EXIT CODES 💀

lowkey important, so pay attention 👀 here's what the numbers mean when the command dips out:

• 0 — successful execution ✨ it ate, no notes
• 1 — error 😭 something went sideways
• 2 — command canceled 🙈 you (or something) hit the brakes
• 4 — authentication required 🔐 like, log in first bestie

NOTE: specific commands may have additional exit codes. refer to the command's help for more information 💅 — yes, i'm being fr fr, go check the help if you need the full tea.

---

🍓 EXAMPLE 🍓

okay here's where it gets iconic, live demos:

# Link monalisa's project 1 to her repository "my_repo"
$ gh project link 1 --owner monalisa --repo my_repo

# Link monalisa's organization's project 1 to her team "my_team"
$ gh project link 1 --owner my_organization --team my_team

# Link monalisa's project 1 to the repository of current directory if neither --repo nor --team is specified
$ gh project link 1

see that last one? if you don't specify --repo or --team, it goes for the repository of the current directory 🧚 sneaky but cute.

---

🎀 SEE ALSO 🎀

• gh-project(1) — the whole project family, go meet the relatives 💜

---

and that's the page!! 🌟 this masterpiece is from GitHub CLI v2.102.0, dated Oct 2026 — mwah, go link some stuff bestie 💅💖