Need help with taskwarrior-pomodoro?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

214 Stars 21 Forks MIT License 105 Commits 14 Opened issues


Simple OSX tray application allowing you to use Pomodoro techniques with Taskwarrior

Services available


Need anything else?

Contributors list


A simple application allowing you to use Pomodoro techniques with Taskwarrior on OSX.


You can download the latest version from the release page here, and install it by dragging the application into your Applications directory.


Configuring Taskwarrior Pomodoro is handled by adding lines to your

file. See below for what features you can configure.

Taskwarrior Application Path

Taskwarrior-pomodoro relies on your local installation of Taskwarrior for interacting with your task list. It will search in several common places for the

app, but if you would like to override the path it selects by default or have installed
into an uncommon location, you can override it by setting the key
in your

Task List Filter

By default, the list of tasks is limited to displaying only tasks that are currently pending (

), but you can specify any filter you'd like for further reducing that list by setting the key
in your

While at work, for example, you could limit your tasks to only pending tasks having the

tag by adding a line as follows:

Note that taskwarrior filters can be quite complex (although my specific use of this feature will not be particularly helpful, it may help you come to terms with what is possible by knowing that the one I used for generating the above screenshot was

pomodoro.defaultFilter=(intheamtrellolistid:5591ecedb12a520b50d2e8b8 or intheamtrellolistid:559173de3295c9b2e550243f or intheamtrellolistid:55aee69377ccc07e295462a3) and (-work)
) and are thus outside the scope of this document, but you can find more information about filters in Taskwarrior's documentation.

Task List Sorting

To enable sorting you need to set


To find more, take a look into sorting section in Taskwarrior's reports documentation.

Post-Pomodoro Hook

You can configure Taskwarrior Pomodoro to call a script of your choice after you complete a Pomodoro. The script will receive one additional command-line argument: the UUID of the task that you were working on. You could use this for a variety of things, including updating goal-tracking software or recording billable hours.


Pomodoro Counter

By default, Taskwarrior Pomodoro will display a running count of Pomodoros completed during each day. If you'd like to disable the display of this running count, you can turn it off by setting the

setting to

Pomodoro Duration

By default, Taskwarrior Pomodoro uses standard 25-minute (1,500 second) pomodoros. You can override the default duration by adding a setting named

setting the number of seconds you'd like a pomodoro to last. For example; to set your pomodoros to last 45 minutes (2,700 seconds), you could set this setting as follows:

Task project

By default, Taskwarrior Pomodoro do not include project name in task list. If you need tasks to be prefixed by project names, and to customize default separator symbol you could set following setting as follows:

pomodoro.prefixSeparator=" - "

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.