Skip to content
πŸ’» Simple and flexible CLI Tool for your daily JIRA activity (supported on all OSes)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

jirax

forthebadge forthebadge forthebadge forthebadge

Build Status npm npm made with nodejs styled with prettier license PRs Welcome

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

Interface

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

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

Open issue details in CLI

Interface

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

Interface

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

List of Completed issues

Interface

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

Interface

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

Interface

Interface

Assign issues to another user

Interface

Interface

Self Assign an Issue

Interface

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

Interface

Asciicast Preview

asciicast

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 junipd2@gmail.com

You can’t perform that action at this time.