---
name: "gh-project"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-project"
---

# gh-project(1)

Work with GitHub Projects.

## NAME

gh-project - Work with GitHub Projects.

## SYNOPSIS

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

## 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

- **[gh-project-close(1)](/gh-project-close/1.md)**

  Close a project

- **[gh-project-copy(1)](/gh-project-copy/1.md)**

  Copy a project

- **[gh-project-create(1)](/gh-project-create/1.md)**

  Create a project

- **[gh-project-delete(1)](/gh-project-delete/1.md)**

  Delete a project

- **[gh-project-edit(1)](/gh-project-edit/1.md)**

  Edit a project

- **[gh-project-field-create(1)](/gh-project-field-create/1.md)**

  Create a field in a project

- **[gh-project-field-delete(1)](/gh-project-field-delete/1.md)**

  Delete a field in a project

- **[gh-project-field-list(1)](/gh-project-field-list/1.md)**

  List the fields in a project

- **[gh-project-item-add(1)](/gh-project-item-add/1.md)**

  Add a pull request or an issue to a project

- **[gh-project-item-archive(1)](/gh-project-item-archive/1.md)**

  Archive an item in a project

- **[gh-project-item-create(1)](/gh-project-item-create/1.md)**

  Create a draft issue item in a project

- **[gh-project-item-delete(1)](/gh-project-item-delete/1.md)**

  Delete an item from a project by ID

- **[gh-project-item-edit(1)](/gh-project-item-edit/1.md)**

  Edit an item in a project

- **[gh-project-item-list(1)](/gh-project-item-list/1.md)**

  List the items in a project

- **[gh-project-link(1)](/gh-project-link/1.md)**

  Link a project to a repository or a team

- **[gh-project-list(1)](/gh-project-list/1.md)**

  List the projects for an owner

- **[gh-project-mark-template(1)](/gh-project-mark-template/1.md)**

  Mark a project as a template

- **[gh-project-unlink(1)](/gh-project-unlink/1.md)**

  Unlink a project from a repository or a team

- **[gh-project-view(1)](/gh-project-view/1.md)**

  View a project

## 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

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

**[gh(1)](/gh/1.md)**