Jira-term

node.js cli for Jira stuffs - Forked from jira-cli

Download .zip Download .tar.gz View on GitHub

jira-term

This is a fork of the jira-cli project which isn't active at the moment, so I built on top of it. Also, I forked and used the jira-cli project because my current day job has very tightly controlled custom workflows where various fields can be required based on workflow actions, and I wanted to keep that separate.

This is also a project for me to get back into CoffeeScript and to better understand using Travis, GitHub pages, self documenting code, and other tools. Make no mistake, I use this in my daily work, but until version 0.3.0 or so is hit, this might be buggy in edge cases (e.g. custom fields required on create, and so on).

Why use this?

Managing an eight person dev team, plus having work of my own, I'm stuck in Jira about three hours a day. That's answering status questions, attending scrums and pulling lists for people, prepping and tagging releases, and then I have my own queue in Jira for designs and prototype I owe for various projects. Easily an hour of the three I spend is fidning what to click in the Jira UI and then fumbling around. I wanted, and needed, a faster way to get my answers and data in something I'm fairly fast at: shell.

Oh and I love Node.js and CoffeeScript, and since the Jira-cli project had about 80% of what I needed, this all worked out well.

Great, so what does it do now?

  • Lists your issues by default
  • List all projects you have access to
  • Finds an issue by Key (AB-123) or Id (123456)
  • Opens an issue
  • Allows user to add a new ticket to various projects
  • Transitions an issue (shows all available transition states)
  • Adds a worklog to an issue
  • Allow searching to be limited by project id or name
  • Returns results in a simple or detailed output
  • Colors things you care about which is (somewhat) customizable

Where is this thing?

GitHub of course

Any documentation?

Sure thing: GitHub Documentation thanks to grunt-docco

Notes

This is actively being worked on and maintained by me. The list of things I want to do is in the repo README, so head there for an idea. If you want to help, get on it.

Release History

  • 0.0.1 Initial Release
  • 0.0.2 NPM Updates
  • 0.1.0 Stable Release
  • 0.1.1 meta update
  • 0.1.2 meta update
  • 0.1.3 I can't spell

License

Licensed under the MIT license. I forked, you fork, whatever let's all have some fun and get shit done.