Jiraya is a simple CLI to deal with Jira issues.

λ jiraya --help
jiraya - Simple Jira CLI.

Usage:
  jiraya assign <issue> [<username>] [--project=<name>]
  jiraya backlog [--project=<name>]
  jiraya comment <issue> <message> [--project=<name>]
  jiraya comments <issue> [--project=<name>]
  jiraya doing [--user=<user>] [--project=<name>]
  jiraya info <issue> [--project=<name>]
  jiraya move <issue> [<status>] [--project=<name>]
  jiraya open <issue> [--project=<name>]
  jiraya review [--project=<name>]
  jiraya tasks <issue> [--project=<name>]
  jiraya todo [--project=<name>]
  jiraya unassign <issue> [--project=<name>]
  jiraya url <issue>
  jiraya (-h | --help)
  jiraya --version

Options:
  -h --help               Show this screen.
  --version               Show version.
  -p --project=<name>     Jira project name. Also configurable with JIRA_DEFAULT_PROJECT environment variable.

Jiraya uses Basic Auth for authentication on Jira API. You'll need to export the following environment variables:

• JIRA_URL: This is your Jira instance base endpoint, such as: https://mycompany.atlassian.net. If you use Jira on premises, point this to your internal endpoint.
• JIRA_USERNAME: Your Jira username.
• JIRA_PASSWORD: Your Jira username.
• JIRA_DEFAULT_PROJECT: Jira default project. (Optional, all commands support --project)

zsh only

 python3 setup.py configure
 python3 setup.py install

My main workflow consists on:

1. Finding a planned issue to work on: jiraya todo
2. Assigning it to myself: jiraya assign RO-42
3. Moving the issue to "In progress": jiraya move RO-42 "In Progress". Use jiraya move RO-42 to list the available statuses.
4. Adding comments: jiraya comment RO-42 "Jiraya is awesome"
5. Moving to next status: jiraya move RO-42 "Review"
6. Repeat

Can find your preffered jira command? No problem, we have the solution for you: You can always use the jiraya shell. Basically you can execute any jql queries and use the IPython as your main terminal. In jiraya shell you can create variables, save results, export to csv, call and restful api, make coffee.. (just kidding, we can't automate the coffe process..yet). and you can use this to create a new operation and submmit a pull request with your brand rocking new operation.

we don't have tutorials, but we are working on that

MIT