---
name: "taskwarrior-tui"
section: "1"
platform: "linux"
package: "taskwarrior-tui"
version: "0.27.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/taskwarrior-tui"
---

# taskwarrior-tui(1)

A terminal user interface for taskwarrior (https://github.com/kdheepak/taskwarrior-tui)

## NAME

taskwarrior-tui — A terminal user interface for taskwarrior (https://github.com/kdheepak/taskwarrior-tui)

## SYNOPSIS

`taskwarrior-tui`

**taskwarrior-tui** is a terminal user interface for `taskwarrior`.

## EXAMPLES

- `taskwarrior-tui`

  Starts a terminal user interface for `taskwarrior`.

- `alias tt=taskwarrior-tui`

  Add the above to your dotfiles to use `tt` to start `taskwarrior-tui`.

## KEYBINDINGS

Keybindings:

- `Esc`

  Exit current action

- `]`

  Next view - Go to next view

- `[`

  Previous view - Go to previous view

Keybindings for task report:

- `/`

  task {string} - Filter task report

- `a`

  task add {string} - Add new task

- `d`

  task {selected} done - Mark task as done

- `e`

  task {selected} edit - Open selected task in editor

- `j`

  {selected+=1} - Move down in task report

- `k`

  {selected-=1} - Move up in task report

- `J`

  {selected+=pageheight} - Move page down in task report

- `K`

  {selected-=pageheight} - Move page up in task report

- `g`

  {selected=first} - Go to top

- `G`

  {selected=last} - Go to bottom

- `l`

  task log {string} - Log new task

- `m`

  task {selected} modify {string} - Modify selected task

- `q`

  exit - Quit

- `s`

  task {selected} start/stop - Toggle start and stop

- `t`

  task {selected} +{tag}/-{tag} - Toggle {uda.taskwarrior-tui.quick-tag.name} (default: `next`)

- `u`

  task undo - Undo

- `v`

  {toggle mark on selected} - Toggle mark on selected

- `V`

  {toggle marks on all tasks} - Toggle marks on all tasks in current filter report

- `x`

  task delete {selected} - Delete

- `z`

  toggle task info - Toggle task info view

- `A`

  task {selected} annotate {string} - Annotate current task

- Ctrl-e

  scroll down task details - Scroll task details view down one line

- Ctrl-y

  scroll up task details - Scroll task details view up one line

- `!`

  {string} - Custom shell command

- `1-9`

  {string} - Run user defined shortcuts

- `:`

  {task id} - Jump to task id

- `c`

  context switcher menu - Open context switcher menu

- `R`

  report switcher menu - Open report switcher menu

- `?`

  help - Help menu

Keybindings for filter / command prompt:

- `Ctrl + f | Right`

  move forward - Move forward one character

- `Ctrl + b | Left`

  move backward - Move backward one character

- `Ctrl + h | Backspace`

  backspace - Delete one character back

- `Ctrl + d | Delete`

  delete - Delete one character forward

- `Ctrl + a | Home`

  home - Go to the beginning of line

- `Ctrl + e | End`

  end - Go to the end of line

- `Ctrl + k`

  delete to end - Delete to the end of line

- `Ctrl + u`

  delete to beginning - Delete to the beginning of line

- `Ctrl + w`

  delete previous word - Delete previous word

- `Alt + d`

  delete next word - Delete next word

- `Alt + b`

  move to previous word - Move to previous word

- `Alt + f`

  move to next word - Move to next word

- `Alt + t`

  transpose words - Transpose words

- `Up`

  scroll history - Go backward in history matching from beginning of line to cursor

- `Down`

  scroll history - Go forward in history matching from beginning of line to cursor

- `TAB | Ctrl + n`

  tab complete - Open tab completion and selection first element OR cycle to next element

- `BACKTAB | Ctrl + p`

  tab complete - Cycle to previous element

Keybindings for context switcher:

- `j`

  {selected+=1} - Move forward a context

- `k`

  {selected-=1} - Move back a context

Keybindings for report switcher:

- `j`

  {selected+=1} - Move forward a report

- `k`

  {selected-=1} - Move back a report

Keybindings for calendar:

- `j`

  {selected+=1} - Move forward a year in calendar

- `k`

  {selected-=1} - Move back a year in calendar

- `J`

  {selected+=10} - Move forward a decade in calendar

- `K`

  {selected-=10} - Move back a decade in calendar

## ENVIRONMENT

- `TASKWARRIOR_TUI_TASKWARRIOR_CLI`

  Path to the `task` executable. Defaults to `task` (resolved via `PATH`). Set this to use a non-standard installation of Taskwarrior, e.g. `TASKWARRIOR_TUI_TASKWARRIOR_CLI=/usr/local/bin/task taskwarrior-tui`.

## EXIT STATUSES

- 0

  If everything goes OK.

## AUTHOR

`taskwarrior-tui` is maintained by Dheepak \`kdheepak' Krishnamurthy and other contributors.

**Source code:** `https://github.com/kdheepak/taskwarrior-tui/`

**Contributors:** `https://github.com/kdheepak/taskwarrior-tui/graphs/contributors`