giterm

Giterm

A terminal client for Github 😎

Installation

Installing from source

If you want to build the application yourself, do the following from within your $GOPATH:

$ go get -u github.com/bharath-srinivas/giterm
$ cd $GOPATH/src/github.com/bharath-srinivas/giterm
$ go install ./cmd/giterm

Setup

Giterm requires github personal access token to work. For more information on how to create a personal access token, you can refer to the official documentation here.

When running giterm for the first time, you have to set your personal access token before using the application.

1. Create you personal access token by clicking here. Refer to the Required scopes section when creating the token
2. Copy your personal access token and keep it ready
3. Now set the token by executing the following command:

$ giterm --token [your_personal_access_token]

This will create a new config file at ~/.giterm/config.json.

Required scopes

Giterm requires the following scopes to be selected when creating a personal access token for it to function properly.

Feeds (optional)

If you wish to view your github news feeds along with other data, you have to set your private github news feed URL.

To get your private github news feed URL, execute the following command:

$ curl -u "username" https://api.github.com/feeds | grep -oP '(?<="current_user_url": ")[^"]*'

Running the above command will ask you to enter your github password. After getting the URL, you can set it using the following command:

$ giterm --feeds-url [your_github_feed_url]

Usage

Once everything is setup properly, you can run the application with the following command:

$ giterm

Default key mappings