A CLI Tool to automate the creation of github repositories
This is a simple, CLI tool that helps you to create github repositories. It adds all required integrations, teams, webhooks, etc.. all based on a configuration file that you define.
You can get the binary and play with it in your own environment (or even deploy it wherever you like it). Just go the releases and download the latest one for your platform.
Move the downloaded binary to any place that's in your $PATH, usually you would add it to the local bin:
$ mv ~/Downloads/github-cli /usr/local/bin/github-cli
$ chmod +x /usr/local/bin/github-cli
After you have github-cli up and running we can create our first repository. First of all we have to create a configuration file that will customise how our repositories will be created. You can have a look at our example and copy it.
You will need to fill in the following values to be able to create a repo:
GitHub needs a token with repo access. You can add additional collaborators and/or teams, the teams are defined by ID and the ID can be found with this simple cURL:
$ curl -s -i -X GET -u TOKEN:x-oauth-basic -d '' https://api.github.com/orgs/hellofresh/teams | grep -A1 "TEAM_NAME"
Check out descriptions on the other config values in the sample file.
This is used for creating GitHub tests. This just needs a GitHub token with repo access.
You can either write this file to be next to the binary or add it to ~/.github.toml, we recommend the latter!
github-cli [command] [--flags]
| Command | Description |
|---|---|
github-cli repo create [--flags] |
Creates a new github repository |
github-cli repo delete [--flags] |
Deletes a github repository |
github-cli hiring send [--flags] |
Creates a new hellofresh hiring test |
github-cli hiring unseat [--flags] |
Removes external collaborators from repositories |
github-cli update |
Check for new versions of github-cli |
github-cli version |
Prints the version information |
To start contributing, please check CONTRIBUTING.