issue

Command line tool for displaying issues using the issuemd library.

GitHub plugin is included.

issue can be extended with plugins for different issue tracking systems.

Installation

$ npm install -g issue 

Usage (GitHub plugin)

List issues from local GitHub repo

cd into local GitHub repo and run the list command...

$ cd bootstrap
$ issue github list

List issues from online GitHub repo

Specify the target project with the --repo flag

$ issue github list --repo twbs/bootstrap

Show individual issue

To show individual issue, add the issue number as the last argument...

$ issue github show --repo twbs/bootstrap <issue-number>

... or from within github project ...

$ issue github show <issue-number>

Show filtered list of issues

The list command supports standard GitHub filters: 'filter', 'state', 'labels', 'sort', 'direction', 'since'

$ issue github list --state open

Locate repositories

$ issue github locate <search-term>

Locate command can be used to find any repositories on GitHub.

Standard GitHub filters are supported: 'in', 'size', 'forks', 'fork', 'created', 'pushed', 'user', 'repo', 'language', 'stars'

For example, to find all repositories containing bootstrap keyword written in assembly.

$ issue github locate bootstrap --language assembly

Limit check

If you are not logged in, GitHub limits you to 60 core requests per half hour, but if logged in, you get 5000.

$ issue github limit

Output:

core requests: 27/60, resets in: 24 mins
search requests: 10/10, resets in: 2 mins

GitHub login

$ issue github login

To increase the request limit, and get access to your own private repositories you should login with your GitHub credentials.

GitHub login creates a personal access token for issuemd on your GitHub account. Personal access tokens are named:

$ issuemd/issue-<username>@<computer-name>

This enables you to login and use issue from multilple locations at the same time.

GitHub logout command clears out credentials from your .issuerc configuration file.

$ issue github logout

Personal issues

Once you are logged in, you can list all your assigned issues in all projects.

$ issue github list mine

Configuration

Change directory to where you want to store your configuration, and run init command...

$ issue init

This will create .issuerc configuration file in your current directory - typically your home folder, or in a project folder to create overrides.