ghproj
Add GitHub Issues and Pull Requests to GitHub Projects.
Motivation
I manage a lot of OSS projects, so I have to handle a lot of issues and pull requests. So I want to manage them using a GitHub Project.
I've developed this tool to gather issues and pull requests of all my OSS in a single GitHub Project. By executing this tool periodically by GitHub Actions schedule event, you can add issues and projects to GitHub Projects automatically.
Blog Post
- Japanese
- English
Environment variables
- GITHUBTOKEN: (Required) GitHub access token
- GHPROJCONFIG: Configuration file path
- GHPROJCONFIGTEXT: Configuraiton content. This is useful if you want to manage the configuration in a GitHub Actions Workflow file
- GITHUBGRAPHQLURL: GraphQL API URL. Defaults to GitHub.com. Set this to use a different GitHub instance. Example: https://github.company.com/api/graphql
GitHub Access token
ghproj needs a GitHub access token. You need to pass a token via environment variable GITHUBTOKEN.
There are two options.
- (Recommendation) If you use GitHub Organization Project, you can use a GitHub App
- If you use GitHub User Project, you can use a classic personal access token
GitHub App is much safer than classic personal access token, so we recommend the option 1.
GitHub Actions token is unavailable to manage GitHub Projects.
fine-grained personal access token is unavailable because it doesn't support GitHub Projects.
https://github.com/orgs/community/discussions/36441
There are also some APIs that do not yet support the fine-grained permission model, that we'll be adding support for in time: - Packages - Projects - Notifications