Skip to main content

tohe - The friendly TODO list helper

Project description


tohe - the TODO list helper


pip3 install tohe


General usage information


Tags can be supplied via -t TAG1 TAG2. Operations that add tags also expect tags in the form -t TAG1 TAG2. Operations that remove tags work similar, but expect the flag -r, like -r REMOVETAG1 REMOVETAG2.

Supported operations:

  • add
tohe add [-t TAG [TAG ...]] [CONTENT]

If CONTENT is not provided, $EDITOR will be opened to get content for the entry.

  • list
tohe list [-t TAG [TAG ...]]

Not supported yet: Tag filtering

  • edit
tohe edit [-t TAGS [TAGS ...]] [-r RTAGS [RTAGS ...]] ID
  • search
tohe search [-w] TERM

-w|--wildcard enables the use of * and ? wildcards

  • delete
tohe delete ID



poetry install

Unit tests

poetry run pytest --cov=tohe/ tests/
# or
poetry run python -m pytest --cov=tohe/ tests/


poetry run mypy tohe/
# or
poetry run python -m mypy tohe/


  • Add support for currently unsupported options like -db and --loglevel.
  • Add Bash and Zsh completion
  • Add docstrings
  • Maybe enable tag editing in the editor (i.e. tags: main,todo,test)
  • Build a web server around it for easier reading and editing
  • Add fzf support for searching
  • Add ncurses TUI

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

tohe-0.2.1.tar.gz (7.9 kB view hashes)

Uploaded Source

Built Distribution

tohe-0.2.1-py3-none-any.whl (8.6 kB view hashes)

Uploaded Python 3

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