vit(1) User Manuals vit(1)NAME
VIT - Visual Interactive Taskwarrior
SYNOPSISvit [-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 eas‐
ily 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 infor‐
mation 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 descrip‐
tion
cmd :%s/OLD/NEW/ change OLD to NEW in the current task's descrip‐
tion
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 comple‐
tion
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 ALSOvitrc(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)
