vit man page

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>

Referenced By

vitrc(5).

User Manuals