ghad: The GitHub Administration Tool
ghad is a command-line tool for managing a large number of GitHub repositories. It currently allows you to:
- Archive repositories that haven't been updated in a specified number of days
- Enable security alerts for vulnerable dependencies
- Enable automated security fixes
It can be run manually, or set up to run from a continuous integration system - see the CircleCI configuration.
Install Node.js 10+.
Clone this repository.
Set your GitHub token.
View the documentation.
npx ghad --help
Run the script as a dry run.
npx ghad archive --org <something>
To actually archive repositories:
npx ghad archive --org <something> --apply
--org is optional. See
npx ghad archive --help for more info.
Usage in TTS
Warning: Keep write access to this repository restricted. The associated GitHub token is that of an Owner, so being able to run arbitrary commands in CI allows privilege escalation.