Skip to content
Projects

pimutils/todoman has 602 GitHub stars and 104 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-09 02:04 UTC. Last push 2026-05-25.

How these counts are measured

✅ Simple, standards-based, command line todo (aka: task) manager.

What you can do

  • Listing, editing and creating todos.
  • Todos are read from individual ics files from the configured directory. This matches the vdir <https://vdirsyncer.readthedocs.org/en/latest/vdir.html>_ specification.
  • There's support for the most common TODO features for now (summary, description, location, due date and priority).
  • Todoman should run on any major operating system (except Windows).

Measured star growth

in 24h
0
in 7 days
0
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

Todoman

CI status <https://builds.sr.ht/~whynothugo/todoman/commits/main>_ | Coverage <https://codecov.io/gh/pimutils/todoman>_ | Documentation <https://todoman.rtfd.org/>_ | ISC Licence <https://github.com/pimutils/todoman/blob/main/LICENCE>_

Todoman is a simple, standards-based, cli todo (aka: task) manager. Todos are stored into icalendar <https://tools.ietf.org/html/rfc5545>_ files, which means you can sync them via CalDAV <http://en.wikipedia.org/wiki/CalDAV>_ using, for example, vdirsyncer <https://vdirsyncer.readthedocs.org/>_.

Todoman is now part of the pimutils project, and is hosted at GitHub <https://github.com/pimutils/todoman>_.

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.

Feel free to join the IRC channel: #pimutils on irc.libera.chat.

Features

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

Documentation

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

.. _readthedocs: https://todoman.readthedocs.org/

LICENCE

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

Explore related projects