LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

gh-project

Manage GitHub project boards and work items

TLDR

List projects
$ gh project list
copy
View a project
$ gh project view [number]
copy
Create a project
$ gh project create --title "[title]"
copy
Add item to project
$ gh project item-add [number] --url [issue_url]
copy
Delete a project
$ gh project delete [number]
copy

SYNOPSIS

gh project command [options]

DESCRIPTION

gh project manages GitHub Projects (project boards) from the command line. It enables organizing and tracking work with customizable views, fields, and automation.Projects can contain issues, pull requests, and draft items organized into boards with custom columns and filters. The command provides full lifecycle management from creation through closure.

PARAMETERS

--owner owner

Owner of the project (user or organization).
--title title
Project title.
--url url
Issue or PR URL to add.
--format format
Output format (e.g. json).
-q, --jq expression
Filter JSON output with a jq expression.

SUBCOMMANDS

list

List projects.
view
View a project.
create
Create a project.
copy
Copy a project.
edit
Edit project settings.
close
Close a project.
delete
Delete a project.
link / unlink
Link or unlink a repository or team to a project.
mark-template
Mark a project as a template.
item-add
Add an existing issue or PR to a project.
item-create
Create a draft item in a project.
item-edit
Edit an item's field values.
item-archive
Archive an item.
item-delete
Remove an item.
item-list
List project items.
field-create / field-list / field-delete
Manage custom fields on a project.

SEE ALSO

gh(1), gh-issue(1), gh-pr(1), gh-repo(1)

Copied to clipboard
Kai