Skip to main content

command line utility for interacting with jira

Project description


Simple command line utility to interact with your jira instance.


  • with easy_install or pip:

    sudo easy_install jira-cli
    sudo pip install jira-cli
  • from source (bitbucket repository):

    hg clone
    cd jira-cli
    python build
    sudo python install
  • after installation, a few configuration steps will be prompted upon invoking jira-cli for the first time:

    ali@home ~ $ jira-cli
    base url for your jira instance (e.g
    enter username:ali
    enter password:*********

    The details of your jira instance will be kept in ~/.jira-cli/config and the authentication token will be stored in ~/.jira-cli/auth. Once the authentication token has expired you will be reprompted for your username & password again.


A few examples to get started.

create an issue with only a title in project TP with default priority and type Bug:

ali@home ~ $ jira-cli -n Bug -t "Test Bug" --priority=Major -p TP
link                 :
assignee             :
summary              : Test Bug
issue                : TP-24
reporter             : ali

create an issue with priority Major and a description:

ali@home ~ $ jira-cli -n Bug -t "Test Bug" --priority=Major -p TP the description
link                 :
assignee             :
summary              : Test Bug
issue                : TP-25
reporter             : ali

list the issue TP-25:

ali@home ~ $ jira-cli TP-25
link                 :
assignee             :
summary              : Test Bug
issue                : TP-25
reporter             : ali

list the issues TP-20 & TP-21:

ali@home ~ $ jira-cli TP-20 TP-21
link                 :
assignee             : ali
summary              : test
issue                : TP-20
reporter             : ali

link                 :
assignee             :
summary              : Test Bug
issue                : TP-21
reporter             : ali

list the issues in short form:

ali@home ~ $ jira-cli TP-20 TP-21 TP-22 --oneline
TP-20 test < >
TP-21 Test Bug < >
TP-22 Test Bug < >

add a comment to an existing issue:

ali@home ~ $ jira-cli -j TP-20 -c this is a new comment
this is a new comment added to TP-20

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for jira-cli, version 0.1.6-3-g7c96d5a
Filename, size File type Python version Upload date Hashes
Filename, size jira_cli-0.1.6_3_g7c96d5a-py2.7.egg (9.4 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size jira-cli-0.1.6-3-g7c96d5a.tar.gz (4.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page