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:

    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. 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"

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.2.9
Filename, size File type Python version Upload date Hashes
Filename, size jira_cli-0.2.9-py2.7.egg (12.1 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size jira-cli-0.2.9.tar.gz (5.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 Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page