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
Filename, size just-start-0.5.1.tar.gz (24.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page