Skip to content
Simple OSX tray application allowing you to use Pomodoro techniques with Taskwarrior
Branch: master
Clone or download
Latest commit be77fc3 Feb 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
TWMenu Auto migrate to swift 4.2 Sep 25, 2018
Taskwarrior Pomodoro.xcodeproj
Taskwarrior Pomodoro Release v1.9.0-beta.2 Feb 17, 2019
.gitignore Adding new 'createArchive' script. Feb 28, 2016
LICENSE.txt Updating license to actually include the year/copyright holder. Jan 15, 2016
SwiftyJSON.swift migrated to swift 4.0 and SwiftyJsone 4.1.0 Jul 24, 2018 Release 1.1.0; adds several updates from @Yoi-Nami-Ra. Jan 22, 2016


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 ~/.taskrc 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 task app, but if you would like to override the path it selects by default or have installed task into an uncommon location, you can override it by setting the key pomodoro.taskwarrior_path in your ~/.taskrc.


Task List Filter

By default, the list of tasks is limited to displaying only tasks that are currently pending (status:pending), but you can specify any filter you'd like for further reducing that list by setting the key pomodoro.defaultFilter in your ~/.taskrc.

While at work, for example, you could limit your tasks to only pending tasks having the work 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 pomodoro.default.sort key.


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 pomodoro.displayCount setting to false:


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 pomodoro.durationSeconds 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:

You can’t perform that action at this time.