Skip to main content

A simple personal task queue to track todo items

Project description


Proof of concept for a simple task queue, with a focus on UX and clean internal design.

Screenshot of a tasks session

Tasks can be installed through pip: pip3 install tasks, run with tasks.

Status for i3

Follow these steps to add the output of status to your i3 status bar.

  1. Set up a cron job (crontab -e) that saves the status every minute.

    * * * * * /path/to/tasks status > $HOME/.tasks.status
  2. Configure i3 to use the provided status wrapper (installed alongside the tasks command.)

        status_command tasks-i3status

Ubiquitous Capture

It is very useful to have a quick and low-friction way to add new items from anywhere. This can be achieved by combining tasks with a generic dialog tool and your window manager keybindings.

Example using zenity and i3:

bindsym $mod+t exec --no-startup-id bash -c "zenity --title 'Add TODO item' --text 'What needs to be done?' --entry --width 450 | xargs tasks addt"

Note that you will want to use tasks >= 2.7.0 for this since it detects external modification of the state file.

Automatic standup email

The standup command shows (among other things) recently completed items. One use case is to send this list to your phone to have it ready for a daily standup. The repo contains a script (under scripts) to send stdin as an email with Mailgun which you can then combine with a cron job as follows.

30 9 * * tue,wed,thu,fri /path/to/tasks standup 1 | /path/to/
30 9 * * mon /path/to/tasks standup 3 | /path/to/


To get started, have a look at the todo items for this project.

make dev_install  # one-time setup
make todo


Pull requests are welcome. Please do keep in mind that the code is heavily inspired by the Elm architecture and consider the following guidelines.

  • Avoid mutation whenever possible, take advantage of PEP 448 to create updated versions of collections instead.
  • Side effects (and only side effects) should be in; all other modules should be limited to pure code.
  • Avoid classes unless you have a really good reason for them (the code does not have any classes at the moment.)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tasks-2.8.0.tar.gz (11.1 kB view hashes)

Uploaded Source

Built Distribution

tasks-2.8.0-py3-none-any.whl (12.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page