1vit(1) User Manuals vit(1)
2
6 VIT - Visual Interactive Taskwarrior
7
10 vit [-audit] <filter>
11
14 VIT (Visual Interactive Taskwarrior) is a lightweight, curses-based
15 front end for Taskwarrior that provides a convenient way to quickly
16 navigate and process tasks. VIT allows you to interact with tasks in a
17 Vi-intuitive way.
18 A goal of VIT is to allow you to customize the way in which you use
20 Taskwarrior's core commands as well as to provide a framework for eas‐
21 ily dispatching external commands (both user scripts and Taskwarrior's
22 many external scripts). For more information on this, see vitrc(5).
23
26 The <filter> consists of zero or more search criteria that select
27 tasks. For more information on this, see task(1).
28
31 Using the -audit option is for debugging purposes and gives more infor‐
32 mation on what's going on behind the scenes.
33
36 cmd a STRING add a new task
37 cmd A STRING add an annotation to the current task
38 cmd m STRING modify the current task
39 cmd :![rw] STRING execute "STRING" in shell. 'r' rereads, 'w'
40 waits
41 cmd t prepend the command prompt with ":!rw task "
42 cmd :s/OLD/NEW/ change OLD to NEW in the current task's descrip‐
43 tion
44 cmd :%s/OLD/NEW/ change OLD to NEW in the current task's descrip‐
45 tion
46 cmd D denotate if over annotation, delete task if on
47 first line
48 cmd e edit the current task
49 cmd = view the current task's info
50 cmd <enter> view the current task's info
51 cmd u undo the last change
52 rpt :REPORT display REPORT
53 rpt :REPORT FILTER display REPORT with FILTER
54 rpt :STRING<tab> display REPORT using tab completion
55 rpt :<tab> display REPORT using tab completion of all
56 defined reports
57 cmd q exit after confirmation
58 cmd Q exit
59 cmd ZZ exit
60 cmd :q exit
61 cmd f FILTER filter the current report with FILTER
62 cmd d mark the current task done
63 nav j move down one line
64 nav DownArrow move down one line
65 nav Spacebar move down one line
66 nav :N move to task number N
67 nav 0 move to the first line
68 nav gg move to the first line
69 nav H move to the first line on screen
70 nav G move to the last line
71 nav L move to the last line on screen
72 nav M move to the middle line on screen
73 nav k move up one line
74 nav UpArrow move up one line
75 cmd N move to the previous match when searching
76 cmd n move to the next match when searching
77 nav ^l refresh (redraw) the display
78 nav ^f scroll down (forward) one page
79 nav PgDn scroll down (forward) one page
80 nav ^b scroll up (back) one page
81 nav PgUp scroll up (back) up one page
82 cmd /STRING search forwards for regular expression STRING
83 cmd ?STRING search backwards for regular expression STRING
84 cmd P [hmln] set the current task's priority to H, M, L, or
85 none
86 cmd p STRING set the current task's project to STRING
87 cmd p STRING<tab> set the current task's project to STRING using
88 tab completion
89 cmd p <tab> set the current task's project using tab comple‐
90 tion
91 help :h view the whole help file
92 help :h cmd view help about commands
93 help :h help view help about help
94 help :h nav view help about navigation
95 help :h rpt view help about reports
96 help :h PATTERN view help file lines matching PATTERN
97
100 ~/.vitrc
101 User configuration file.
102
105 Copyright (C) 2012 - 2013, Steve Rader
106 Copyright (C) 2013 - 2018, Scott Kostyshak
107 VIT is distributed under GNU General Public License version 3 or (at
110 your option) any later version. See http://www.gnu.org/licenses/ for
111 more information.
112
115 vitrc(5), task(1)
116 The official site is
119 <http://tasktools.org/projects/vit.html>
120 The official code repository is
123 <https://git.tasktools.org/EX/vit.git>
124 You can contact the project by emailing
127 <support@taskwarrior.org>
128 For a different but related program, see
131 https://github.com/blindFS/vim-taskwarrior
132
135 Bugs in VIT may be reported to the issue-tracker at
136 <http://taskwarrior.org>
137 vit(1)