Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

To-do list

Flag: --use-done
Env: $TODOTXT_TUI_USE_DONE
Conf: use_done
Determines whether projects, contexts, and tags from completed tasks should be included in the lists of available projects, contexts, and tags.
  • Default: false

Flag: --pending-sort
Env: $TODOTXT_TUI_PENDING_SORT
Conf: pending_sort
Sorting options to apply to pending tasks. Priority of sorting options is decreasing from left to right. If empty, tasks are not sorted.
  • Possible Values (Flag): reverse, priority, alphanumeric, alphanumeric-reverse, create-date-asc, create-date-desc, finish-date-asc, finish-date-desc, due-date-asc, due-date-desc
  • Possible Values (Config): Reverse, Priority, Alphanumeric, AlphanumericReverse, CreateDateAsc, CreateDateDesc, FinishDateAsc, FinishDateDesc, DueDateAsc, DueDateDesc
  • Default: empty

Sorting Options:

  • Reverse: Reverse the order of tasks.
  • Priority: Sort tasks by priority.
  • Alphanumeric: Sort tasks in alphanumeric order.
  • AlphanumericReverse: Sort tasks in reverse alphanumeric order.
  • CreateDateAsc: Sort tasks by creation date, ascending. Tasks without a creation date are placed last.
  • CreateDateDesc: Sort tasks by creation date, descending. Tasks without a creation date are placed last.
  • FinishDateAsc: Sort tasks by finish date, ascending. Tasks without a finish date are placed last.
  • FinishDateDesc: Sort tasks by finish date, descending. Tasks without a finish date are placed last.
  • DueDateAsc: Sort tasks by due date, ascending. Tasks without a due date are placed last.
  • DueDateDesc: Sort tasks by due date, descending. Tasks without a due date are placed last.

Flag: --done-sort
Env: $TODOTXT_TUI_DONE_SORT
Conf: done_sort
Sorting options to apply to completed tasks. Priority of sorting options is decreasing from left to right. If empty, tasks are not sorted.
  • Possible Values (Flag): reverse, priority, alphanumeric, alphanumeric-reverse, create-date-asc, create-date-desc, finish-date-asc, finish-date-desc, due-date-asc, due-date-desc
  • Possible Values (Config): Reverse, Priority, Alphanumeric, AlphanumericReverse, CreateDateAsc, CreateDateDesc, FinishDateAsc, FinishDateDesc, DueDateAsc, DueDateDesc
  • Default: empty

Flag: --delete-final-date
Env: $TODOTXT_TUI_DELETE_FINAL_DATE
Conf: delete_final_date
Specifies whether to delete the final date (if it exists) when a task is moved from completed back to pending.
  • Default: true

Flag: --set-final-date
Env: $TODOTXT_TUI_SET_FINAL_DATE
Conf: set_final_date
Configures how the final date is handled when a task is marked as completed.
  • Possible Values (Flag): override, only-missing, never
  • Possible Values (Config): Override, OnlyMissing, Never
  • Default: OnlyMissing

Final Date Options:

  • Override: Set the final date every time a task is marked as completed.
  • OnlyMissing: Set the final date only if it is not already set.
  • Never: Never set the final date.

Flag: --set-created-date
Env: $TODOTXT_TUI_SET_CREATED_DATE
Conf: set_created_date
Specifies whether to set the creation date when a new task is added. If the user provides their own creation date, it will still be added regardless of this setting.
  • Default: true