I suppose everyone needs to track the things they need to do. Since a long time I try to follow the getting things done method and its workflow. The basic assumptions are quite convincing and it helps me to be more confident that nothing falls through the cracks.

Like others I tried and used lots of different tools to implement it over the years ranging from Outlook tasks to Emacs Orgmode and a lot between.

Since a while I try to reduce the tools I use to simple ones and in particular I want to independent of the operating system I use. This leads to using plain-text as a basis and for a long time I was happy using Orgmode. It’s awesome software but - being based on Emacs - there includes an incredible amount of options and capabilities. Hence on average I spent more time fiddling with the tooling rather than closing tasks. In the meantime I moved away from Emacs for text processing and didn’t want to keep it just for task management. Hence I looked for something simple and came across todotxt.

Todotxt sits in the sweet spot between being simple and hence just working and being powerful enough to support all my needs.

In case you want to give it a try here is how I set it up and the tools I use.

Setup

At its core it is a set of rules how tasks are written into a plain text file together with a command line script to manage it. The quick start guide describes the installation but on the Windows platform you should rather install it in WSL (the windows subsystem for Linux) rather than using cygwin.

While there are a number of GUI tools available for the different platforms I stick to the CLI usually in the terminal of Visual Studio Code.

Configuration file

I keep the todo file in a separate folder so I set TODO_DIR to that folder.

I like the coloring of the output and set a few items:

export PRI_A=$YELLOW              
export COLOR_PROJECT=$BROWN       
export COLOR_CONTEXT=$GREEN       
export COLOR_DATE=$BLUE
export COLOR_NUMBER=$LIGHT_GRAY
export COLOR_META=$CYAN

Shell

I have set these commands in my bashrcand .zshrc:

export TODOTXT_DEFAULT_ACTION=ls
alias t='todo.sh'
alias ta='todo.sh add'
alias txp='todo.sh xp -o -7'
source ~/.todo/todo_completion

The first one allows me to call a shorter alias for todo.sh to get a listing of my tasks The next two aliases simple reduce the keystrokes I need to enter to run commands. The third one sets parameters for one of the plugins I use see below.

Plugins

Part of the power of it lies in the fact that you can extend the core cli by add-ons. You can find a long list in the todotxt wiki. You can install them following this guide. Most of these add-ons are shared as git repos so I clone it onto a subdirectory of ~/.todo/.todo.actions.d/.

Here are the ones that I find useful:

• add: This add on replaces the builtin command to add new tasks with the creation date prepended. Thus I can see when something entered my task lists.
• autopri: with this add on I can increae the priority based on due dates.
• average: my own for statistics purposes see below
• birdseye: I use it to get an overview over the projects and their completion status. It’s one way to look at my “project list” according to GTD.
• dorecur: This adds capabilities for recurring tasks (and I have a lot of those I want to keep track of!)
• due: It displays tasks that are overdue or due today or tomorrow. I use it with the optional parameter 7 to show things due in the next 7 days during my weekly review.
• gimme: to unblock myself I get a random tasks from one of my contexts 😏
• graph: overview over amount of done tasks. It’s meant as a “don’t break the chain” type of tool but I use it to see how my task completion varies over the days. This is an interesting part of the reflection phase of the weekly review.
• view: It shows tasks in a several ways see below. I use it to show my “action list” and “project list” according to GTD.
• xp: I use it to get an overview of done tasks.

Mobile tools

One of the things I like is that there are good mobile clients to manage tasks also on the go. On Android I use Simpletask which is free and open source and on iOS I use Swifttodo which isn’t free but worth the price in my opinion.

Usage

During the day

Here are the commands I use regularly to get an overview of my tasks:

todo view past shows overdue tasks and tasks due today. I run this at least once in the morning to see if there are any deadlines I missed and hence need to prioritise or renegotiate.

todo view tomorrow shows tasks due to day or tomorrow. Similarly I run this at least once to get an idea if there are any deadlines I need to keep in mind.

todo ls @context shows me all tasks for a single context which is the main view I need during the day to see what I might do next.

During the weekly review

As part of the “get current” phase of my weekly review I use these commands:

• todo view context to see my action lists in a single place.
• todo view project to review my action lists per project and see the project completion status.
• Once I have marked the tasks that were closed I run todo xp (or rather the alias txp I have set) to check if there are any follow up actions from closed tasks.
• todo due 7 to understand what’s due in the next seven days
• todo birdseye allows me to look at my projects list and see the project completion status. This helps me to see what I may need to focus on the next week.

Part of my self-reflection during the weekly review is to look at the cycle time of my tasks. My aim is to close all tasks within a month from entering it on average. Here close can also mean that I decide to cancel it because priorities may have changed or a project doesn’t seem worthwhile any more.

Thanks to the simplicity of the todotxt format it was easy for me to create an add on that calculates these averages. That’s also an example of the advantages of this tool and format: I’m absolutely sure you can develop this in Emacs-lisp as well. Unfortunately it exceeds my lisp knowledge by far but it’s well within my python capabilities 😄. If you want to give it a try you can find it on Github.