# jira-node-cli

> JIRA command line interface

Latest version **1.2.1** (published 2019-04-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install jira-node-cli
pnpm add jira-node-cli
yarn add jira-node-cli
bun add jira-node-cli
```

Provides the command `jira`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.1 |
| Published | 2019-04-06 |
| First published | 2018-03-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 8 |
| Dependencies | 7 |
| Unpacked size | 38.8 KB |
| Known vulnerabilities | 0 (+25 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 54 |
| Author | Łukasz Usarz |
| Maintainers | lusarz |
| Keywords | jira, cli, node, issues, command, line |

## Links

- npm: https://www.npmjs.com/package/jira-node-cli
- Repository: https://github.com/lusarz/jira-node-cli
- Homepage: https://github.com/lusarz/jira-node-cli#readme
- Issues: https://github.com/lusarz/jira-node-cli/issues
- npm.io page: https://npm.io/package/jira-node-cli

## Dependencies (7)

- [axios](https://npm.io/package/axios.md) ^0.17.1
- [colors](https://npm.io/package/colors.md) ^1.1.2
- [moment](https://npm.io/package/moment.md) ^2.20.1
- [opener](https://npm.io/package/opener.md) ^1.5.1
- [inquirer](https://npm.io/package/inquirer.md) ^5.1.0
- [commander](https://npm.io/package/commander.md) ^2.13.0
- [clipboardy](https://npm.io/package/clipboardy.md) ^1.2.2

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.2.1 (latest) — 2019-04-06
- 1.2.0 — 2019-01-01
- 1.1.6 — 2018-03-15
- 1.1.5 — 2018-03-13
- 1.1.4 — 2018-03-12
- 1.1.3 — 2018-03-11
- 1.1.2 — 2018-03-10
- 1.1.1 — 2018-03-10
- 1.1.0 — 2018-03-09
- 1.0.0 — 2018-03-01

## README

# JIRA CLI   [![Build Status](https://circleci.com/gh/lusarz/jira-node-cli/tree/master.png?style=shield)](https://circleci.com/gh/lusarz/jira-node-cli)   [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Interesting%20JIRA%20Command%20Line%20Interface%20written%20in%20node&url=https://github.com/lusarz/jira-node-cli&hashtags=jira,cli,node)

    Usage: jira [options] [command]

    Options:

      -h, --help                output usage information

    Commands:

      create-issue              Create new issue
      issue-link [issueName]    Copy issue link to clipboard
      issue-status [issueName]  Show issue status
      issue [issueName]         Show issue details
      jql [jql]                 Show issues using JQL
      all                       Alias => jira jql ''
      my-issues                 Alias => jira jql 'assignee in (currentUser()) ORDER BY status ASC'
      my-not-released           Alias => jira jql 'status not in (Released) AND assignee in (currentUser()) ORDER BY status ASC'
      my-stage                  Alias => jira jql 'status in ('Deployed to Stage') AND assignee in (currentUser()) ORDER BY status ASC'
      sprint                    Alias => jira jql 'sprint in openSprints() ORDER BY status ASC'
      stage                     Alias => jira jql 'status in ('Deployed to Stage') ORDER BY status ASC'


![jira-all](https://user-images.githubusercontent.com/10059264/37196314-a3a24e6a-2376-11e8-8711-5de5a1f353d0.png)

![jira-issue](https://user-images.githubusercontent.com/10059264/37196325-b12e75c2-2376-11e8-9e20-4dcdbacde2cc.png)


## Tips
Commands like `jira all`, `jira my-not-released` are implemented as [aliases](https://github.com/lusarz/jira-node-cli/blob/master/lib/aliases/my-stage.js). I'm planning to allow user to create his own aliases but currently there is a few hardcoded, so you may meet error like:

    JIRA respond with '400 Bad Request' status.
    ERROR MESSAGE:
    The value 'Released' does not exist for the field 'status'.
    Please try again later
                                                                                                                                                           	
As a workaround please use plain `jira jql` queries, for example:
    
    jira jql 'project=ABC AND status in (New)'
    jira jql 'assignee in (currentUser()) ORDER BY status ASC' 
    jira jql 'project=XYZ AND assignee in (currentUser()) ORDER BY status ASC'                                                                                                                                                       	.


## Install

    npm install -g jira-node-cli
    

## Usage

Type:

    jira
    
and you will be asked about credentials to your JIRA account. Credentials will be saved in `~/.jirarc` file.

---
_Source: https://npm.io/package/jira-node-cli · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._