Basic Usage

Setup

The first thing you need to do is to run:

$ gub setup

This will ask for your username and password to request a Github token which will be stored (your password won't).

You can then list all your repositories:

$ gub repos

Suppose you have forked someone/example at myuser/example. You may do:

$ gub clone myuser/example

This will clone and set a remote named "upstream" to follow someone/example.

You then can do:

$ gub issues

And it would list all issues on myuser/example if it has issues enabled. If not, it will list issues from someone/example.

You can filter issues assigned to you by adding --mine to the command.

You may then do:

$ gub start 123

And it would synchronize your master with someone/example, then creates a new branch issue-123 and finally will checkout the issue-123 branch.

When you're done working on an issue and still have the issue-123 checked out, execute:

$ gub finish

Which will automatically add a pull-request to issue #123.