gh projects

GitHub CLI extension for projects (beta). As of v2.9.0, gh already has some support for projects but may not support projects (beta) until the APIs have stabilized.

Install

Make sure you have version 2.0 or newer of the GitHub CLI installed.

gh extension install heaths/gh-projects

Upgrade

The gh extension list command shows if updates are available for extensions. To upgrade, you can use the gh extension upgrade command:

gh extension upgrade heaths/gh-projects

# Or upgrade all extensions:
gh extension upgrade --all

Commands

clone

Clone a project:

gh projects clone 1 --title "A new project title"
gh projects clone 1 --t "A private clone" --private -d "Private feature work"

edit

Edit a project:

gh projects edit 1 -d "A short description" --public
gh projects edit 1 --add-issue 4 --add-issue 8
gh projects edit 1 --add-issue 4,8 -f Status=Todo -f Iteration="Iteration 1"

list

List projects:

gh projects list
gh projects list --search "launch"

view

View a project:

gh projects view 1

License

Licensed under the MIT license.