jira-cli

Command line interface for Jira

npm install jira-cli
1 downloads in the last day
3 downloads in the last week
83 downloads in the last month

jira-cli

Build Status

This is a command line client for jira, because no one likes their terrible interface.

Getting Started

  • Install the module with: npm install -g jira-cli
  • Run it with jira

What does it do?

  • Lists all a user's issues
  • List all a user's projects
  • Finds an issue by Key (AB-123) or Id (123456)
  • Opens an issue
  • Allows user to add a new ticket to different projects
  • Transitions an issue (shows all available transition states)
  • Adds a worklog to an issue
  • Allow searching to be limited by project id

TODO

  • PROFIT?
  • MOAR testing

Documentation

GitHub Documentation

Examples

jira -l

jira -f AB-123

Notes

If you use https: for jira, add "protocol": "https:" to your .jiraclirc.json If your ssl certs are also self-signed add: "strictSSL": false to your .jiraclirc.json

Testing

Using jasmine-node with grunt currently. Tests are a bit silly, but they helped me learn jasmine spies. So that's good.

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using grunt.

Release History

  • 0.5.0 Changing list (-l) to to use the query resolution = unresolved (Thanks to zowens)
  • 0.4.1 Accidentally quitting before callback was finished
  • 0.4.0 Now able to ignore self-signed SSL Certs and specify protocol
  • 0.3.1 Fixed some bugs
  • 0.3.0 Updated version of jira
  • 0.2.9 Fixed an issue where special characters were in the username
  • 0.2.8 Fixed issue with create that would prevent you from creating
  • 0.2.7 Fixed typo that prevented -w from working
  • 0.2.6 Now takes -o to limit to specific project(s)
  • 0.2.5 Now normalizing event types and item types
  • 0.2.4 I did something here, don't remember
  • 0.2.3 Fixed an issue where invalid input caused an exception
  • 0.2.2 Added wordrap to -d so that the text is easier to grok
  • 0.2.1 Added -d flag to show details for list/find
  • 0.2.0 Refactored organization. Creates config file if not present
  • 0.1.9 Defaults for project in config, lists others if desired
  • 0.1.8 Now allows entry of worklog when transitioning items, or by itself
  • 0.1.7 Now requiring my custom npm module for node-jira-devel
  • 0.1.6 Transitioning now shows all available options
  • 0.1.5 Listing Id for project
  • 0.1.4 Listing Types in Create
  • 0.1.3 Listing Projects
  • 0.1.2 Moar Minor Doc Changes
  • 0.1.1 Minor Doc Changes
  • 0.1.0 Initial Release

License

Copyright (c) 2012 Chris Moultrie
Licensed under the MIT license.

npm loves you