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

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.

REPORTING BUGS

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