A simple tool to retrieve and update your GitHub status from your terminal
# Get your current status $ ghstatus Current status: 🐋 Containerizing and shipping all the things
# Update your status $ ghstatus set :whale: Containerizing all the things! 🎉 Updated your status! # Or set yourself as busy $ ghstatus --busy set :sleeping: Taking a nap 🎉 Updated your status!
Head over to the releases page and get your ghstatus binary!
Once you've downloaded a binary and made it executable, run it once and head over to the newly-generated config file (located in
~/.config/ghstatus/config.json by default, you can change this behaviour by setting the
--config flag to point to your file location of choice) and enter your GitHub access token. The token has to be permitted to access the following scopes:
Note: If you want to add quotes or other special characters to your status message, please escape them correctly using backslashes.
To see the full list of supported operations, simply execute
All of the included functionality is achieved by using a few great packages, such as
- mapstructure for handling JSON -> map -> struct workflows
- aurora for all of the terminal colors
- emoji for the
This project is licensed under the MIT License