My avatar logoInom Turdikulov

Jun 25, 20233 min read

Taskwarrior

Taskwarrior is Free and Open Source Software that manages your TODO list from the command line. It is flexible, fast, and unobtrusive. It does its job then gets out of your way.
— Taskwarrior

Generally Taskwarrior is CLI To-Do list manager.

Features

  • plain text format (avoid proprietary formats)
  • cross-platform
  • open-source
  • CLI
  • many extensions and integrations, like Taskwarrior Server and Taskwarrior TUI
  • integrations, most popular Timewarrior and Taskserver, TODO: add note/use it

Quickstart

NEXT: convert into flashcards

You can run task diagnostics to check if everything is set up correctly.

Add task, need to finish tomorrow, which recurs each 10 days: task add test_description due:tomorrow recur:10d

Update a task’s priority: task task_id modify priority:H|M|L

Complete or delete a task: task task_id done, task task_id delete

List open tasks due before the end of the week with tag next: task list due.before:eow +next

List all reports: task reports

List all projects: task projects

Some general notes available in Babej taskwarrior tutorial 1.

NixOS task service provide good command to generate script, which can be used to import required credentials 2:

nixos-taskserver user export organization user > user_config.sh
# import this somewhere
sh user_config.sh

# adjust server settings
taskd.server=your-server.com:53589

# initialize sync and sync
task init sync
task sync

Create blocked task (depends on)
... depends:id. To list task which blocking everything use this command: ... +BLOCKING -BLOCKED

How do I use and make sense of recurrence 3

task add recur:<duration> due:<first task due date> until:<delete first task by date> wait:<date when task will appear> "my task"
 
task add recur:daily \  # Create a new occurrence everyday
         due:9:00    \  # Required attribute for recurring task, eat breakfast at 9:00 AM
         until:12:00 \  # Automatically remove task by lunch time 12:00 PM
         wait:5:00   \  # Wait until 5:00 AM to show the task
         eat breakfast

Examples (we automatcally remove the tasks if they no more relevant, e.g. until):

task add recur:daily due:... until:... wait:... +next \
"Process INBOX tasks lists"

task add recur:daily due:... until:... wait:... +next \
"Complete today\'s workout routine."

task add recur:daily due:... until:... wait:... +next \
"Review and practice new English vocabulary words."

task add recur:daily due:... until:... wait:... +next \
"Engage in focused learning session for personal development."

Recurrence can also use until and wait attributes, if they exist. Recurrence does not use scheduled. And there is a mask attribute, that tracks which instance of the reoccurence the task is.

When a new recurring instance is created:

  • new task due = parent due + recur * mask
  • identical math for both until and wait
  • scheduled is copied wholesale from the parent task. In practice, this unexpected behaviour won’t break your workflow, just affects filters and skews urgency. I call this out because it took me a very long time to discover this was not working as expected.

Every time taskwarrior runs, it checks to see if it’s time to create the next occurrence. The psuedo-equation is:

now >= due + recur * (mask + 1)`

Note, there is a config value, rc.recurrence.limit, that can be used to tell taskwarrior to create even more occurrences further out.

You can expect the next occurrence to be created at the due date of the previous.

References

Footnotes

  1. Babej-A dive into taskwarrior ecosystem ↩

  2. Taskwarrior - Kunzelma Wiki ↩

  3. How to manage recurring tasks in taskwarrior? - Unix & Linux Stack Exchange ↩

Graph View

Backlinks