Github Pull Request notification utility
Majordome is a simple cli program to generate notifications if you have open/outstanding pull-request reviews on Github. It can also be used to display the pull-requests on the command line.
The notifications are linked to the search in the format:
type:pr is:open review:required review-requested:<username>
Installing:
npm install -g majordome
Setup:
- Majordome requires a github token to be present in your home directory
~/.github - Generate a Github token, the permissions required will depend on what you want to monitor in your account.
- Add token to
~/.github
majordome check
Check for outstanding PR reviews, if there are more than 0 a notification will be triggered.
majordome list
List all the outstanding PR reviews. The will be grouped by repository and the title along with the age of the PR will be displayed. Depending on the terminal, these can also be used as links - typically holding Command (OSX) whilst clicking will trigger the link to open (Terminal.app, iTerm, etc..)
On Linux/Unix, a simple crontab is probably the best way to run this. On OSX
you can use launchctl. As there are a couple of tricky bits involved,
you can run sudo majordome osx-install - this will generate the plist file
and attempt to load it into launchctl (sudo is needed to write
to ~/Library/LaunchAgents)
To check it's installed, run:
launchctl list | grep majordome
If you don't see any results, it may not of loaded correctly, a command will of
been displayed when running the osx-install command. Yuo can run this to
attempt to reinstall, it is in the format
launchctl load -w ~/Library/LaunchAgents/dev.nicksnell.majordome.plist.
Default interval is 3600 (1 Hour), osx-install takes an -i or --interval
argument to customise.
You can unload the schedule at any time by running:
launchctl unload ~/Library/LaunchAgents/dev.nicksnell.majordome.plist