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

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tohe, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size tohe-0.2.1-py3-none-any.whl (8.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size tohe-0.2.1.tar.gz (7.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page