jirax

:sunglasses: :computer: Simple and flexible CLI Tool for your daily JIRA activity (supported on all OSes)

Description

A CLI tool for JIRA for day to day usage with JIRA.Speed up your JIRA activity with this CLI tool.

Programming language: JavaScript

License: MIT License

Tags: Nodejs     JavaScript     Js     CLI     Jira     Productivity    

Latest version: v1.0.0

README

jirax

[](LICENSE)

:star: If you are using this tool or you like it, Star on GitHub — it helps!

A CLI tool for [JIRA](https://www.atlassian.com/software/jira) for day to day usage with JIRA.Speed up your JIRA activity with this CLI tool.

[Interface](assets/terminal.png?raw=true "CLI Help Preview")

Prerequisites

You are required to have Node.js installed to run the cli tool or after installing Node.js you can make executable and run the excutable to use the tool. Make executable

Getting Started

1. Log in to Atlassian and generate your API TOKEN.
2. Copy the API TOKEN

Install Using NPM

You can use directly install the package using NPM or YARN

 npm install -g jirax 

 yarn add jirax

use the below command to get started

 npx jirax

By Cloning the repository

Install all dependency

npm install 

Create the symlink. This command will help you execute jirax commands at global level

npm link or sudo npm link

Usages

Login In Cli

You need to login before using any of JIRAX features.

jirax -l

This will prompt few questions to enter your credentials please enter the credentials to use the CLI.)

$ Your JIRA Host Name (eg: something.atlassian.net)
$ Your JIRA User Name
$ Your API Token 

It will authenticate with JIRA Server and after successfull login, your name will prompt with message

[Interface](assets/login_preview.png?raw=true "Login Preview")

Your Login details will be stored in a JSON file located in

$XDG_CONFIG_HOME or ~/.config.

# access it 
~/.config/configstore/jiraconfig.json

JIRAX Commands

# prints all available commands
jirax --help 

Open the Issue directly in Browser

[Interface](assets/open.png?raw=true "open command preview")

Open issue details in CLI

[Interface](assets/details.png?raw=true "issue details command preview")

View all the issues in browser for a Project (i.e project Key)

[Interface](assets/open_issues.png?raw=true "open issues command preview")

List of all TO DO issues

list of all todo issues for the logged in user. Here project key is optional and if project key is not provided then it will return all the open issues for the user

[Interface](assets/completed_list.png?raw=true "open issues command preview")

List of Completed issues

[Interface](assets/todo_list.png?raw=true "open issues command preview")

View all the issues in browser for a Project (i.e project Key)

[Interface](assets/open_issues.png?raw=true "open issues command preview")

Transtion of issues (move issues from one status to another)

[Interface](assets/move1.png?raw=true "move issues preview")

[Interface](assets/move2.png?raw=true "move issues preview")

Assign issues to another user

[Interface](assets/assign_issues_1.png?raw=true "move issues preview")

[Interface](assets/assign_issues_2.png?raw=true "move issues preview")

Self Assign an Issue

[Interface](assets/assign_me.png?raw=true "move issues preview")

Clear Stored Credentials

In case of your API token revoked or you have revoked the previous API token then you need to clear the previous credentials using the following command and Relogin using command jirax login

[Interface](assets/clear_1.png?raw=true "move issues preview")

[Interface](assets/clear_2.png?raw=true "move issues preview")

Asciicast Preview

Making executable

After cloning the repository. Run this command this command will automatically create plateform specific executables.

 npm run build

Contribution

We hope that you will consider contributing to Jirax. Please read this short overview Contribution Guidelines for some information about how to get started

MIT License

jirax is available under the MIT license. See the LICENSE file for more info.

Copyright (c) 2019 [email protected]