jicli

An interactive Jira CLI

JIRA CLI focused on simple ticket creation, written in Node.

Table of Contents

• Install
• Setup
• Usage
• Examples
• Authentication
• Debugging
• Contribute
• License

Install

> npm install -g jicli

Setup

On first usage, run jicli and you will be asked for your Jira credentials:

> jicli
 
 Jira host:  example.atlassian.com
 Jira username : user1
 Jira password: ***********
 HTTP protocol (http or https) https

Config settings will be saved in <project-root>/.jicli/config.json.

Usage

Run jicli or jicli --help to get usage:

  Usage: jicli [options] [command]


  Commands:

    create [options]  Create a new issue

  Options:

    -h, --help     output usage information
    -V, --version  output the version number

Create

  Usage: create [options]

  Create a new issue

  Options:

    -h, --help                  output usage information
    -p, --project [key]         Project key
    -t, --issue-type [type]     Issue type (numeric or enum{task, story, sub-task, epic, bug})
    -s, --summary [string]      Summary (title)
    -d, --description [string]  Description (opens in editor)
    -x, --skip-description      Skip entering the description field
    -l, --labels [l1,l2,l3]     Labels (comma-delimited)
    -a, --assignee [username]   Assignee (use `me` to assign to yourself)

Config

Usage: config [options]

  Re-initialize your config

  Options:

    -h, --help  output usage information

Jicli uses the find-config package to look for the .jicli folder. The order used:

• Current working directory
• Navigate up parent directories under getting to /
• Finally, look in home directory

If not found, the following is done to determine where to create the .jicli folder:

• If current working directory has a package.json file, create folder here
• If not, navigate up parent directories looking for package.json until you hit /
• If not found, create folder in current directory

Examples

Creating issues

Create issue interactively with prompts:

jicli create

? Project:  Mobile
? Issue Type: Task
? Issue Title:  My new issue

Supply some of the required fields and jicli will ask for the missing items:

jicli create -p MOB -t Task

? Issue Title:  My new issue

Notice that project and issue type prompts are skipped

Holy grail with all required and optional fields ()

jicli create -p MOB -t task -s "My issue title" -d "My issue description" -l 'label1,label2' -a me

Authentication

When you first set up jicli, it will prompt for your username / password. From this, it will create a token and add it to the config file <root>/.jicli/config.json

Debugging

Project uses debug module with debug key jicli. Run:

DEBUG=jicli* jicli create ...

This will add additional debugging information to file <root>/.jicli/logger.log instead of stdout as it's awkward to output to the console while requesting stdin.

Contribute

PRs accepted. Note that code uses standard styling.

License

MIT © Dan Caddigan