Skip to main content

Just Start is a wrapper for Task Warrior with pomodoro support

Project description

Build Status Coverage Status

An app to defeat procrastination!


Just-Start is a to-do list application and productivity booster. It prevents you from procrastinating (too much).

The program is a wrapper for TaskWarrior with a timer implementing the Pomodoro Technique (time management). It also draws a bit of inspiration from Omodoro.


  • Configurable pomodoro phase durations

  • Support for multiple configurations (a.k.a. locations) based on the current time and day of the week

  • Desktop notifications

  • Block time-wasting sites while you’re working

Installation and usage

Supported platforms:

  • Linux

  • macOS


Pick a client name from the table below and run:

$ pip install just-start[<client_name>]
$ just-start-<client_name>

So for the urwid client:

$ pip install just-start-urwid
$ just-start-urwid

Press h to see a list of available user actions.





urwid (recommended)


Inspired by Calcurse. Similar to a graphical application, but in your terminal


Terminal (none)

Example client. Useful for seeing how to write a brand new one but not intended for continuous usage


If you want to help out please install Poetry, clone the repo and run:

$ cd just-start/
$ poetry install

This will ensure you have both the development and install dependencies.

You can also install the package in editable mode to test manually without having to run a build after every change, but you’ll need to generate a since projects using pyproject.toml alone can’t be used this way (see the note about editable mode in PEP517 for more info). I use Dephell for this:

$ cd just-start
$ dephell deps convert --from=pyproject.toml
$ pip install -e just_start

Bug reports

Issues are tracked using GitHub Issues

Running Tests

You just need Poetry and Tox

$ tox

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

just-start-0.5.2.tar.gz (24.9 kB view hashes)

Uploaded source

Built Distribution

just_start-0.5.2-py3-none-any.whl (26.6 kB view hashes)

Uploaded py3

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