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

# [NAME](#NAME)

gh-project - Work with GitHub Projects.

# [SYNOPSIS](#SYNOPSIS)

**gh project <command> \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Work with GitHub Projects.

The minimum required scope for the token is: **project**. You can verify your token scope by running **gh auth status** and add the **project** scope by running **gh auth refresh -s project**.

# [AVAILABLE COMMANDS](#AVAILABLE_COMMANDS)

[**gh-project-close(1)**](#gh_project_close%281%29)

Close a project

[**gh-project-copy(1)**](#gh_project_copy%281%29)

Copy a project

[**gh-project-create(1)**](#gh_project_create%281%29)

Create a project

[**gh-project-delete(1)**](#gh_project_delete%281%29)

Delete a project

[**gh-project-edit(1)**](#gh_project_edit%281%29)

Edit a project

[**gh-project-field-create(1)**](#gh_project_field_create%281%29)

Create a field in a project

[**gh-project-field-delete(1)**](#gh_project_field_delete%281%29)

Delete a field in a project

[**gh-project-field-list(1)**](#gh_project_field_list%281%29)

List the fields in a project

[**gh-project-item-add(1)**](#gh_project_item_add%281%29)

Add a pull request or an issue to a project

[**gh-project-item-archive(1)**](#gh_project_item_archive%281%29)

Archive an item in a project

[**gh-project-item-create(1)**](#gh_project_item_create%281%29)

Create a draft issue item in a project

[**gh-project-item-delete(1)**](#gh_project_item_delete%281%29)

Delete an item from a project by ID

[**gh-project-item-edit(1)**](#gh_project_item_edit%281%29)

Edit an item in a project

[**gh-project-item-list(1)**](#gh_project_item_list%281%29)

List the items in a project

[**gh-project-link(1)**](#gh_project_link%281%29)

Link a project to a repository or a team

[**gh-project-list(1)**](#gh_project_list%281%29)

List the projects for an owner

[**gh-project-mark-template(1)**](#gh_project_mark_template%281%29)

Mark a project as a template

[**gh-project-unlink(1)**](#gh_project_unlink%281%29)

Unlink a project from a repository or a team

[**gh-project-view(1)**](#gh_project_view%281%29)

View a 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)

```
$ 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
```

# [SEE ALSO](#SEE_ALSO)

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

Oct 2026

---

Document: gh-project(1) from gh 2.103.3-r0 (Chainguard OS)
Source: https://github.com/cli/cli