GH-PROJECT-LINK(1) GitHub CLI manual GH-PROJECT-LINK(1)

# [NAME](#NAME)

gh-project-link - Link a project to a repository or a team

# [SYNOPSIS](#SYNOPSIS)

**gh project link \[<number>] \[flags]**

# [OPTIONS](#OPTIONS)

[**--owner** **<string>**](#owner)

Login of the owner. Use "@me" for the current user.

[**-R**, **--repo** **<string>**](#R)

The repository to be linked to this project

[**-T**, **--team** **<string>**](#T)

The team to be linked to this project

# [EXIT CODES](#EXIT_CODES)

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.

# [EXAMPLE](#EXAMPLE)

```
# 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 ALSO](#SEE_ALSO)

[**gh-project(1)**](/man/os/gh/gh-project.1)

Oct 2026

---

Document: gh-project-link(1) from gh 2.102.0-r1 (Chainguard OS)
Source: https://github.com/cli/cli