Skip to content
👌 A simple tool to retrieve and update your GitHub status from your terminal
Go
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
LICENSE.md
README.md
commands.go
config.go
go.mod
go.sum
graphql.go
main.go
status.go
util.go

README.md

ghstatus

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!

installation

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: user, read:org.

usage

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 ghstatus help.

additional notes

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 emoji magic

license

This project is licensed under the MIT License

You can’t perform that action at this time.