Skip to content

Latest commit

 

History

History
218 lines (161 loc) · 5.39 KB

README.md

File metadata and controls

218 lines (161 loc) · 5.39 KB
Raw

jilla

jilla is a Jira client for lazy people.

Installation

Install node.js. Then, in your shell:

$ npm install -g jilla

Usage

First use

$ jilla
JIRA URL: https://jira.atlassian.com/
Username:
Password:
Internet Proxy (leave blank if you don't know):
Good to go!

Print usage instructions

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

Commands:
   ls                          List open issues
   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

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

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

Change status of an issue

$ jilla status PS-656
Current Status : 6 Closed
Statuses available :
21 Reopen
$ jilla status PS-656 21
$ jilla status PS-656
Current Status : 1 Open
Statuses available :
31 Start Progress

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.

Comment on an issue

$ jilla comment IDEA-2 "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.

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

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