This project is abandoned. The NPM module is likely to be changed. The maintainer of https://github.com/danshumaker/jira-cmd approached me asking for the name within npm, and I've granted access. So there will be a whole new package in npm unrelated to this project.

jira-cli

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.