A Jira client for lazy people
Clone or download
Pull request Compare This branch is 10 commits ahead, 7 commits behind juliangruber:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
.gitignore
.jshintrc
README.md
gira
package.json

README.md

jilla

jilla is a Jira client for lazy people.

Installation

Install node.js. Then, in your shell:

$ npm install -g jilla

Usage

First use

Only JIRA URL, Username and Password are mandatory infos. You can leave the other fields blank.

$ jilla
Internet Proxy (http://user:pwd@host:port): 
JIRA URL: https://jira.atlassian.com/
Username: user
Password: passwd
Category: CAT
Sprint Team Name: My Team
Good to go!

gira

If you use git as a repo and if you name your branches after your issueKeys, you can use gira shell script and it will let you use jilla without having to mention each time the issue you are working on.

Print usage instructions

$ jilla
usage: jilla <command> [<args>]

Commands:
   config                      Update jilla configuration
   ls                          List open issues
   statuses                    Different statuses
   sprint                      All sprint issues (JIRA Agile only)
   start     <id>              Start working on an issue
   stop      <id> (--log)      Stop working on an issue (and log time)
   log       <id> <time>       Log work
   running                     List issues in progress
   resolve   <id>              Resolve issue
   reopen    <id>              Reopen issue
   close     <id>              Close issue
   needinfo  <id>              Set issue status to Needs Info
   status    <id> (status)     Changes issue status to "status" (no status to get a list of options)
   search    <term>            Find issues
   describe  <id>              Display issue synopsis
   comments  <id> (--reverse)  Display comments on an issue
   subtasks  <id>              List an issue's subtasks
   comment   <id> "<message>"  Comment on an issue
   user      <term>            Search for a user
   assign    <id> <user>       Assign issue to a user
When using gira and when inside a git repository, id is guessed

Show sprint info

$ jilla sprint
Name               : My Team Sprint 4
State              : ACTIVE
Start Date         : 22/janu./14 9:32 AM
End Date           : 04/febr./14 9:32 AM
Complete Date      : Aucune

Completed Issues   : 0
Incompleted Issues : CAT-14,CAT-42,CAT-50,CAT-64,CAT-81,CAT-99,CAT-110,CAT-122,OTHPROJ-10,OTHPROJ-75,OTHPROJ-82,OTHPROJ-83
Punted Issues      : CAT-63,CAT-71,APROJ-50

Show open issues

$ jilla ls
WDSERVICE-78 <jgruber>  !! LessLinter
PS-656       <jgruber>  !! Graphite installieren
PS-480       <pkostoff>  ! Trailing stops

Show issues in progress

$ jilla running
WDSERVICE-78 2h 30m
PS-656       10m

Start/Stop Progress

$ jilla start PS-656
$ jilla stop  PS-656
Time spent: 2h 30m

Log work

$ jilla log PS-656 2h 30m
# or
$ jilla stop PS-656 --log
Time spent: 2h 30m
#or
$ gira log 4h

Search issues

$ jilla search lesslinter preprocessor
WDSERVICE-78 <jgruber> !! LessLinter
WDSERVICE-79 <fstock>   ! LessLinter testen

Resolve, Close & Reopen

$ jilla resolve PS-656
$ jilla close PS-656
$ jilla reopen PS-656
# or
$ gira close

Describe an issue

$ jilla describe IDEA-2
Ticket:      IDEA-2
Summary:     Scott's Jilla Test Ticket
Status:      Open
Reporter:    Scott Seaward <sseaward@nypublicradio.org>
Assignee:    Scott Seaward <sseaward@nypublicradio.org>
Labels:
Subtasks:    0
Comments:    1
Description:

    This is a ticket to test Jilla on.

# or
$ gira describe

Comment on an issue

$ jilla comment IDEA-2 "Hello, \\ World!"
# or
$ gira comment "Hello, \\ World!"

List comments on an issue, latest at the bottom

$ jilla comments IDEA-2
Author: Scott Seaward
Date:   Fri Mar 08 2013 10:27:36 GMT-0500 (EST)

    damn you \\ space coyote

Author: Godfrey Jones
Date:   Fri Mar 09 2013 08:00:12 GMT-0500 (EST)

    Hello Homer, this is *God*...frey Jones.

# or
$ gira comments

List comments on an issue, latest at the top

$ jilla comments IDEA-2 --reverse
Author: Godfrey Jones
Date:   Fri Mar 09 2013 08:00:12 GMT-0500 (EST)

    Hello Homer, this is *God*...frey Jones.

Author: Scott Seaward
Date:   Fri Mar 08 2013 10:27:36 GMT-0500 (EST)

    damn you \\ space coyote

Search for users

$ jilla user hom
homer     Homer         <homer_the_poet@gmail.com>
hsimpson  Homer Simpson <homer@thesimpsons.net>

Assign a ticket to a user

$ jilla assign IDEA-2 homer
1  Homer <homer_the_poet@gmail.com>
2  Homer Simpson <homer@thesimpsons.net>
Found multiple users, choose one by typing a number and hitting return: 2
Assigned IDEA-2 to user "Homer Simpson <homer@thesimpsons.net>".
# or
$ gira assign homer

Security Warning

Jilla currently stores your JIRA credentials as plaintext. Use a password for JIRA that you don't use anywhere else. You can secure your credentials by issuing the following command on linux:

chmod 700 ~/.jilla

Contributors

License

(MIT)

Copyright (c) 2012-2014 <julian@juliangruber.com>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.