Skip to content

Basic Usage

All you need to know to use pydo effectively are these five commands (add, do, rm, mod and open).


To add a task run:

pydo add Improve the pydo manual

It's also possible to add tags or areas when creating a task:

pydo add Improve the pydo manual ar:task_management +python


To see the open tasks run:

pydo open

By default, open is the default command, so you can run pydo alone. If you don't like the order of the tasks, you can sort them.


If you've completed a task, run:

pydo do {{ task_filter }}

Where {{ task_filter }} can be a task id extracted from the open report or a task expression like ar:task_management +python.


If you no longer need a task, run:

pydo del {{ task_filter }}


To change existent tasks use the following syntax.

pydo mod '{{ task_filter }}' {{ task_attributes }}

Notice that the task_filter needs to be quoted if the filter contains more than one word.

For example, to change the description of the first task, we'd do:

pydo mod 0 Improve the pydo documentation

If you are new to pydo, it's recommended that you stop here, start managing your tasks for a while. When you are comfortable with basic pydo usage, there are many other features you can learn about. While you are not expected to learn all of them, or even find them useful, you might find what you need.

Last update: 2020-07-02