Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/heaths/gh-projects
GitHub CLI extension to manage GitHub Projects (V2).
https://github.com/heaths/gh-projects
gh-extension project-management
Last synced: 3 months ago
JSON representation
GitHub CLI extension to manage GitHub Projects (V2).
- Host: GitHub
- URL: https://github.com/heaths/gh-projects
- Owner: heaths
- License: mit
- Created: 2022-04-23T00:24:16.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-10-17T20:46:21.000Z (over 1 year ago)
- Last Synced: 2024-11-01T14:36:58.476Z (3 months ago)
- Topics: gh-extension, project-management
- Language: Go
- Homepage:
- Size: 99.6 KB
- Stars: 17
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# gh projects
[GitHub CLI] extension for [projects (beta)].
As of [v2.9.0](https://github.com/cli/cli/releases/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.
```bash
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:
```bash
gh extension upgrade heaths/gh-projects
# Or upgrade all extensions:
gh extension upgrade --all
```
## Commands
### clone
Clone a project:
```bash
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:
```bash
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:
```bash
gh projects list
gh projects list --search "launch"
```
### view
View a project:
```bash
gh projects view 1
```
## License
Licensed under the [MIT](LICENSE.txt) license.
[GitHub CLI]: https://github.com/cli/cli
[newer]: https://github.com/cli/cli/releases/latest
[projects (beta)]: https://docs.github.com/en/issues/trying-out-the-new-projects-experience/about-projects