Skip to content
Get Github and Github Enterprise notifications in your Mac OS 
Branch: master
Clone or download
sargsyan Merge pull request #11 from sargsyan/update-configurer-usage-examples
Add a missing line break and add example of deactivation an instance
Latest commit 7ec9943 Nov 27, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates Sep 15, 2018 update to terminal notifier 2.0.0 which does not have problems with o… Sep 19, 2018
test eliminate globbing and splitting from libraries used for notification… Sep 22, 2018
.travis.yml run notification tests as others and fix coverage reporting Jul 23, 2018
LICENSE add license file Jun 2, 2018
Makefile run notifier tests with make Aug 7, 2018 Add Gitter badge Oct 23, 2018 Update Nov 27, 2018 write service log to the natural folder for Mac OSX application logs Jul 26, 2018
github_notif eliminate globbing and splitting from github_notif Sep 22, 2018 do not install and uninstall terminal notifier from brew Sep 16, 2018
logo.png add a simple application logo to notifications Jul 8, 2018 do not install and uninstall terminal notifier from brew Sep 16, 2018


Build Status codecov Join the chat at


Real-time notifications from github and github enterprise instances in your desktop.

Comment notification

Supported for OS X Yosemite and newer versions

Instructions for installation and usage

Instructions for playing with source code


Make sure that you have jq command installed. jq is needed to github API response parsing.


To install the application run

make install

It will post files needed to scheduled run into /Library/LaunchDaemons files of MacOS.

If you want to revert the actions of install then run

make uninstall


The application is designed to run for multiple github instances on the same time.One instance is the others are github enterprise instances. Generally you will need to have one or two configurations. You can list, create, remove, activate and deactivate configurations. to get the help for just run.



If something is not working in your system and you are sure that configurations are correct you can run unit tests for your system to see if system behaves correctly. For this you need to install test framework shell scripts and run unit tests locally

brew install shunit2
make test


To check the daemon logs for the error use

tail -f /var/log/system.log

if the system logs tell that the application keeps exiting with non-zero exit codes, you can check the service logs in the ~/Library/Logs/github_notif/service.log file or locate github_notif folder in Mac OSX Console application.

You can’t perform that action at this time.