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.


Name Framework Notes
urwid (recommended) Urwid Inspired by Calcurse. Similar to a graphical application, but in your terminal
term 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.

Files for just-start, version 0.5.1
Filename, size File type Python version Upload date Hashes
Filename, size just_start-0.5.1-py3-none-any.whl (26.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size just-start-0.5.1.tar.gz (24.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page