.nh
.TH "GH-PROJECT" "1" "Mar 2024" "" "GitHub CLI manual"

.SH NAME
.PP
gh-project - Work with GitHub Projects.


.SH SYNOPSIS
.PP
\fBgh project <command> [flags]\fR


.SH DESCRIPTION
.PP
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'.


.SH AVAILABLE COMMANDS
.TP
\fBgh-project-close(1)\fR
Close a project

.TP
\fBgh-project-copy(1)\fR
Copy a project

.TP
\fBgh-project-create(1)\fR
Create a project

.TP
\fBgh-project-delete(1)\fR
Delete a project

.TP
\fBgh-project-edit(1)\fR
Edit a project

.TP
\fBgh-project-field-create(1)\fR
Create a field in a project

.TP
\fBgh-project-field-delete(1)\fR
Delete a field in a project

.TP
\fBgh-project-field-list(1)\fR
List the fields in a project

.TP
\fBgh-project-item-add(1)\fR
Add a pull request or an issue to a project

.TP
\fBgh-project-item-archive(1)\fR
Archive an item in a project

.TP
\fBgh-project-item-create(1)\fR
Create a draft issue item in a project

.TP
\fBgh-project-item-delete(1)\fR
Delete an item from a project by ID

.TP
\fBgh-project-item-edit(1)\fR
Edit an item in a project

.TP
\fBgh-project-item-list(1)\fR
List the items in a project

.TP
\fBgh-project-link(1)\fR
Link a project to a repository or a team

.TP
\fBgh-project-list(1)\fR
List the projects for an owner

.TP
\fBgh-project-mark-template(1)\fR
Mark a project as a template

.TP
\fBgh-project-unlink(1)\fR
Unlink a project from a repository or a team

.TP
\fBgh-project-view(1)\fR
View a project


.SH EXAMPLE
.EX
$ 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

.EE


.SH SEE ALSO
.PP
\fBgh(1)\fR