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>