Issues

A lightweight command line issues manager written in ruby.

Motivation

Issues allows you to manage your bugs, improvements and tasks from the command line as part of your source git repository. Each issue created is assigned a random id, which allows for git-style DICS (distributed issue control system). No need to install an issue tracker with all its dependencies.

Usage

Creating issues:

issues create "Issues title"
Options:
          --bug, -b:   create a bug
  --improvement, -i:   create an improvement
         --task, -t:   create a task
         --help, -h:   Show this message

Will create a bug, improvement or task, respectively. When no option [-b | -i | -t] is given, issues will try to guess the type, based on keywords contained in the heading, defaulting to creating a task.

Listing issues:

issues
issues list

Options:
           --all, -a:   list all issues
        --newest, -n:   list newest issues first (not supported yet)
        --oldest, -o:   list oldest issues first (not supported yet)
       --verbose, -v:   verbose list of issues
          --bugs, -b:   list bugs
  --improvements, -i:   list improvements
         --tasks, -t:   list tasks
          --help, -h:   Show this message

Print a specific issue including its description.

issues list ID

Resolving issues:

issues resolve ID
issues wontfix ID
issues duplicate ID OTHER_ID

Options:
  --commit, -c:   do a git commit
    --help, -h:   Show this message

Using the --commit option is equivalent to doing a git commit -a -m "Resolved issue #{ID} #{ISSUE_TITLE}. When specifying an ID, it is sufficient to give the first few digits, just enough that an open issue can be uniquely identified.

Deleting issues:

issues delete ID

Editing issues:

issues edit ID

Options:
  --description, -d:   edit the issue description
         --help, -h:   Show this message

Updating the issue type:

issues set-type {bug|improvement|task} ID [ID2 ...]

Example

> issues create "Put water in kettle"
Created issue 992b87 Put water in kettle
> issues create "Put kettle on stove"
Created issue bbe372 Put kettle on stove
> issues create "Turn on stove"
Created issue 531eff Turn on stove
> issues create "Wait until water is boiling."
Created issue 851129 Wait until water is boiling.
> issues
992b87 (T) Put water in kettle                                                                         
bbe372 (T) Put kettle on stove                                                                         
531eff (T) Turn on stove                                                                               
851129 (T) Wait until water is boiling. 

> issues list bbe
#=====================================================================================================#
# bbe372 Task (open)  2012-06-20 20:22                                                                #
#                                                                                                     #
# Put kettle on stove                                                                                 #
#                                                                                                     #
#-----------------------------------------------------------------------------------------------------#
# Log:                                                                                                #
#-----------------------------------------------------------------------------------------------------#
# 2012-06-20 20:22 Issue created                                                                      #
#=====================================================================================================#

dmarsic/Issues