Scroll to navigation

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

NAME

gh-project - Work with GitHub Projects.

SYNOPSIS

gh project <command> [flags]

DESCRIPTION

Work with GitHub Projects. Note that the token you are using must have 'project' scope, which is not set by default. 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

Close a project

Copy a project

Create a project

Delete a project

Edit a project

Create a field in a project

Delete a field in a project

List the fields in a project

Add a pull request or an issue to a project

Archive an item in a project

Create a draft issue item in a project

Delete an item from a project by ID

Edit an item in a project

List the items in a project

Link a project to a repository or a team

List the projects for an owner

Mark a project as a template

Unlink a project from a repository or a team

View a project

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)

Jan 2025