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.
$ npm install -g issue
cd into local GitHub repo and run the list command...
$ cd bootstrap
$ issue github list
Specify the target project with the --repo flag
$ issue github list --repo twbs/bootstrap
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>
The list command supports standard GitHub filters: 'filter', 'state', 'labels', 'sort', 'direction', 'since'
$ issue github list --state open
$ 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
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
$ 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
Once you are logged in, you can list all your assigned issues in all projects.
$ issue github list mine
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.