NAME

       ti — issue tracking system built on Git

SYNOPSIS

       ti COMMAND [ARGUMENTS]

DESCRIPTION

       ti,  short  for  ticgit,  is an issue tracker based on the Git revision control system.  It allows you to
       store bugs in your project in a separate ticgit  or  ticgit-ng  branch  of  its  development  repository,
       thereby keeping open issues close to the source without cluttering the tree.

       Every ticket consists of the following information:

       Title     A  short  summary  of  the problem.  This can be compared to the subject of an e-mail or to the
                 first line of a Git commit message.

       Ticket ID The Ticket ID (TicId) is the SHA-1 hash of the file which holds the ticket  name  (which  is  a
                 normalized  form of the title including the time of ticket creation and a small random number).
                 It is used to uniquely identify a ticket.

       Number    Apart from TicIds, tickets can also be referred to by using their number.  This will  often  be
                 preferred  to  TicIds  when  using  ticgit  from the command line (i.e., in everyday work), but
                 ticket numbers are not persistent (they change with every ti list invocation).

                 In the current version of ticgit, ti list does not show numbers any more, but they can still be
                 used (by counting manually).

       State     A ticket can either be open, resolved, invalid or put on hold.

       Assignment
                 The e-mail address of the person working on the ticket.

       Tag       A custom label which tells more about the nature of a ticket.  A  typical  example  is  feature
                 (not  a bug, but a feature suggestion). ticgit associates no special semantics to tags, you are
                 free to choose them however you like.

                 Tickets can have an arbitrary number of tags.

       Points    You can use this integer value to assign some numerical  value,  such  as  a  measure  for  the
                 importance, to each ticket.  Again, ticgit does not dictate how to use this field.

       Comments  Comments provide a simple form of communication between bug reporters and developers.

COMMANDS

       ti supports the following commands:

       list      List  tickets.  By default, only open issues are shown; to show tickets in other states, use -s
                 STATE.  You can also select by tag (-t TAG) or by assignment (-a ADDRESS).  When running  list,
                 small  integer  numbers  will  be  assigned  to all shown tickets; you may use them to refer to
                 tickets in other commands until you call list again.

       state     Pass a ticket ID and a state specification to set the ticket's state information.  You can omit
                 the ticket ID to work on the current ticket.

       show      Show everything known about the specified ticket.  You can omit  the  ticket  ID  to  show  the
                 current ticket.

       new       Create  a  new  ticket.   This  will  launch an editor to let you enter a title, more detailled
                 information about the issue, and some tags.  Initially, the ticket will be in the open state.

       checkout  Set the current ticket.

       comment   Add a comment to the ticket specified on the command line.  If you do not pass one, the current
                 ticket will be used.

       tag       Pass a ticket ID and a tag name to add a label to an issue.  You can omit the ticket ID to  tag
                 the current ticket.  If you use the -d option, the tag will be removed instead of added.

       assign    Assign  the  specified  ticket to you (or to the given user, when -u ADDRESS is given).  If you
                 omit the ticket ID, the current ticket will be assigned.  Otherwise, you can prepend -c to  the
                 ticket ID to perform the checkout operation after assigning the ticket.

       points    Pass  a  ticket  ID  and some integer to assign a point value to the given ticket.  If you only
                 pass a number, this command manipulates the current ticket.

       sync      Synchronize tickets with the remote repository specified on the command line.   This  uses  the
                 underlying  push  and pull command implemented in Git, so you can use your usual named remotes.
                 The default remote is origin.

       recent    Get a human-readable changelog of the tickets maintained by ticgit.   This  command  takes  its
                 information straight from the commit messages of the ticgit(-ng) branch.

       These commands show usage information about themselves when passed the --help option.

FILES

       ~/.ticgit/, ~/.ticgit-ng/
                 The ticket cache.

AUTHOR

       ticgit is Copyright © 2008 Scott Chacon <schacon@gmail.com>.

       ticgit-ng is Copyright © 2011 Jeff Welling <jeff.welling@gmail.com>.

       This  manual  page  was  written  by  Michael Schutte for the Debian GNU/Linux system (but may be used by
       others).

                                                                                                           ti(1)