Visual Interactive Taskwarrior

From Gentoo Wiki
(Redirected from Vit)
Jump to:navigation Jump to:search
This article is a stub. Please help out by expanding it - how to get started.

Visual Interactive Taskwarrior (vit) is an curses-based front-end for Taskwarrior with vim-like keybindings. Like vim, vit has extensive internal online help documentation. While intended to be intuitive to vim users vit is highly configurable and alternative key bindings entirely possible.


USE flags

USE flags for app-misc/vit A lightweight, fast, curses-based front end to Taskwarrior

test Enable dependencies and/or preparations necessary to run tests (usually controlled by FEATURES=test but can be toggled independently)


root #emerge --ask app-misc/vit

Additional software

As the name Visual Interactive Taskwarrior suggests, Taskwarrior (task) is required for vit to function.


Environment variables

  • $VIT_DIR - specifies the location of the vit configuration directory.


The $VIT_DIR can force a configuration directory location to a location other than the default or an XDG directory.

  • ~/.vit/config.ini - the default location for the vit configuration file directory.
  • <any valid xdg dir>/vit/config.ini - the XDG compliant configuration file location.

The default config.ini is heavily commented and intended to be studied by the end user for maximum customization.


Just as with Taskwarrior, it's possible to store tasks on a remote server with Taskserver.



user $vit --help
vit --help
usage: vit [options] [report] [filters]

VIT (Visual Interactive Taskwarrior)

  -h, --help      show this help message and exit
  -v, --version   show program's version number and exit
  --list-actions  list all available actions
  --list-pids     list all pids found in pid_dir, if configured

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

While VIT is running, type :help followed by enter to review basic command/navigation actions.

See for more information.



root #emerge --ask --depclean --verbose app-misc/vit

See also

  • Taskwarrior — to-do list manager for the command line
  • Taskserver — a back-end service for providing to-do list synchronization between Taskwarrior and clients or remote devices.
  • Timewarrior — a time management tool for the terminal.