Skip to main content

command line utility for interacting with jira

Project description


Simple command line utility to interact with your jira instance.

build status


  • with easy_install or pip:

    sudo easy_install jira-cli
    sudo pip install jira-cli
  • from source:

    git 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. Alternatively you can provide the username and password on the command line as:

    ali@home ~ $ jira-cli --user=ali --password=sekret ...


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

provide your own formatting:

ali@home ~ $ jira-cli TP-20 --format="%reporter, %summary, %status"

free text search for issues:

ali@home ~ $ jira-cli --search some random words

list only the comments for an issue:

ali@home ~ $ jira-cli --comments-only TP-20
Thu Nov 10 08:42:55 UTC 2011 ali : this is a new comment
Fri Dec 02 00:19:40 UTC 2011 ali : another comment
Sat Mar 10 11:08:34 UTC 2012 ali : test comment
Sat Mar 10 11:08:51 UTC 2012 ali : another test comment

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.3.9
Filename, size File type Python version Upload date Hashes
Filename, size jira_cli-0.3.9-py2.7.egg (13.2 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size jira-cli-0.3.9.tar.gz (6.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