Awesome Open Source
Awesome Open Source


.. image:: :target: :alt: CI status

.. image:: :target: :alt: Codecov coverage report

.. image:: :target: :alt: documentation

.. image:: :target: :alt: version on pypi

.. image:: :target: :alt: licence

.. image:: :target: :alt: code style: black

Todoman is a simple, standards-based, cli todo (aka: task) manager. Todos are stored into icalendar <>_ files, which means you can sync them via CalDAV <>_ using, for example, vdirsyncer <>_.

Todoman is now part of the pimutils project, and is hosted at GitHub <>_.

Todoman should run fine on any Unix-like OS. It's been tested on GNU/Linux, BSD, and macOS. We do not support windows, and very basic testing seems to indicate it does not work.


  • Listing, editing and creating todos.
  • Todos are read from individual ics files from the configured directory. This matches the vdir <>_ specification.
  • There's support for the most common TODO features for now (summary, description, location, due date and priority) for now.
  • Todoman should run on any major operating system (except Windows).
  • Unsupported fields may not be shown but are never deleted or altered.


For detailed usage, configuration and contributing documentation, please consult the latest version of the manual at readthedocs_.

.. _readthedocs:


Todoman is licensed under the ISC licence. See LICENCE for details.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
python (48,353
terminal (646
productivity (221
todo (78
tasks (43
caldav (14
icalendar (14

Find Open Source By Browsing 7,000 Topics Across 59 Categories