DragonFly On-Line Manual Pages

vit(1)                           User Manuals                           vit(1)

NAME
       VIT - Visual Interactive Taskwarrior

SYNOPSIS
       vit [-audit] <filter>

DESCRIPTION
       VIT (Visual Interactive Taskwarrior) is a lightweight, curses-based
       front end for Taskwarrior that provides a convenient way to quickly
       navigate and process tasks. VIT allows you to interact with tasks in a
       Vi-intuitive way.

       A goal of VIT is to allow you to customize the way in which you use
       Taskwarrior's core commands as well as to provide a framework for
       easily dispatching external commands (both user scripts and
       Taskwarrior's many external scripts). For more information on this, see
       vitrc(5).

FILTER
       The <filter> consists of zero or more search criteria that select
       tasks.  For more information on this, see task(1).

AUDIT
       Using the -audit option is for debugging purposes and gives more
       information on what's going on behind the scenes.

COMMANDS
        cmd   a STRING        add a new task
        cmd   A STRING        add an annotation to the current task
        cmd   m STRING        modify the current task
        cmd   :![rw] STRING   execute "STRING" in shell. 'r' rereads, 'w'
       waits
        cmd   t               prepend the command prompt with ":!rw task "
        cmd   :s/OLD/NEW/     change OLD to NEW in the current task's
       description
        cmd   :%s/OLD/NEW/    change OLD to NEW in the current task's
       description
        cmd   D               denotate if over annotation, delete task if on
       first line
        cmd   e               edit the current task
        cmd   =               view the current task's info
        cmd   <enter>         view the current task's info
        cmd   u               undo the last change
        rpt   :REPORT         display REPORT
        rpt   :REPORT FILTER  display REPORT with FILTER
        rpt   :STRING<tab>    display REPORT using tab completion
        rpt   :<tab>          display REPORT using tab completion of all
       defined reports
        cmd   q               exit after confirmation
        cmd   Q               exit
        cmd   ZZ              exit
        cmd   :q              exit
        cmd   f FILTER        filter the current report with FILTER
        cmd   d               mark the current task done
        nav   j               move down one line
        nav   DownArrow       move down one line
        nav   Spacebar        move down one line
        nav   :N              move to task number N
        nav   0               move to the first line
        nav   gg              move to the first line
        nav   H               move to the first line on screen
        nav   G               move to the last line
        nav   L               move to the last line on screen
        nav   M               move to the middle line on screen
        nav   k               move up one line
        nav   UpArrow         move up one line
        cmd   N               move to the previous match when searching
        cmd   n               move to the next match when searching
        nav   ^l              refresh (redraw) the display
        nav   ^f              scroll down (forward) one page
        nav   PgDn            scroll down (forward) one page
        nav   ^b              scroll up (back) one page
        nav   PgUp            scroll up (back) up one page
        cmd   /STRING         search forwards for STRING
        cmd   ?STRING         search backwards for STRING
        cmd   P [hmln]        set the current task's priority to H, M, L, or
       none
        cmd   p STRING        set the current task's project to STRING
        cmd   p STRING<tab>   set the current task's project to STRING using
       tab completion
        cmd   p <tab>         set the current task's project using tab
       completion
        help  :h              view the whole help file
        help  :h cmd          view help about commands
        help  :h help         view help about help
        help  :h nav          view help about navigation
        help  :h rpt          view help about reports
        help  :h PATTERN      view help file lines matching PATTERN

FILES
       ~/.vitrc
              User configuration file.

CREDITS & COPYRIGHTS
       Copyright (C) 2012 - 2013, Steve Rader
       Copyright (C) 2013 - 2014, Scott Kostyshak

       VIT is distributed under GNU General Public License version 3 or (at
       your option) any later version. See http://www.gnu.org/licenses/ for
       more information.

SEE ALSO
       vitrc(5), task(1)

       For more information regarding VIT, see the following:

       The official site at
              <http://tasktools.org/projects/vit.html>

       The official code repository at
              <git://tasktools.org/vit.git/>

       You can contact the project by emailing
              <support@taskwarrior.org>

REPORTING BUGS
       Bugs in VIT may be reported to the issue-tracker at
              <http://taskwarrior.org>

                                                                        vit(1)