Extending functionality with add-ons

You can also extend Todo.txt with plug-ins, while a large repository of such user-contributed add-ons are listed on the project’s wiki ( https://github.com/todotxt/todo.txt-cli/ wiki/Todo.sh-Add-on-Directory), which is hosted on GitHub.

You must first create the ~/.todo.actions.d directory. Next, you must inform Todo.txt of the location of the add-ons directory. This is done in the todo.cfg file.

Open the file in your favourite text editor and scroll down to the #export TODO_ACTIONS_

DIR="$HOME/.todo.actions.d" line. Remove the leading # so that the line isn’t ignored and save the file.

You can now store the add-ons you wish to use in the ~/.todo.actions.d directory. Navigate to the said directory and clone the due plug-in with the git clone https://github.com/ rebeccamorgan/due.git command. When adding tasks to the list, you can use the due:YYYY-MM-DD format to add the due date: todo -t add Draft the written statement for NCF cases due:2018-02-06 . You can similarly add the due date for all tasks and you can use the todo ls due command to list all the tasks that have due date assigned to them. But this usage doesn’t provide any intelligent output about the tasks with the due date.

Using the due plug-in however, you can get a list of all the tasks which are overdue or due today with the todo due command. You can also get a list of all tasks due in the next n days using the todo due n command. The command produces no results if there are no due tasks as per the criteria.