1. Ian Cordasco
  2. todo.py


todo.py /

Filename Size Date modified Message
docs [7583395d6d7b]
14 B
32 B
94 B
332 B
705 B
35.1 KB
39 B
1.1 KB
2.4 KB
2.5 KB
1.4 KB
1.3 KB
37.4 KB


Build Status

A port of the popular todo.txt-cli project from bash to python.


This only requires GitPython if you want to have todo.py also manage a git repository which tracks the related files. Running the script once will give you the URL to download it. Please note that GitPython is written for git --version 1.7.2+.

If you're on Windows and running the script out of cmd.exe, install colorama for 'termcolor' support.


From the repo

If you want to install the copy locally (i.e. to a personal directory) you can simply download one of the packages and run the install.sh script.

Be sure to run ./install.sh -h first. You can decide where you would like the script installed (the default is $HOME/bin/) and where you would like an alias for the script, e.g., t or tpy, written (the default is $HOME/.bashrc).

Using pypi

If you would prefer a system-wide installation, you can use install todo.py from PyPi like so:

$ pip install todo.py

Be aware that making a system-wide installation will not automattically create an alias for your use. You will have to edit either your .bashrc or .bash_profile (or respective shell configuration filse) to include something along the lines of:

alias t='$HOME/bin/todo.py'


Enjoy, contribute, and feel free to clone. I'm doing this blind [1] as best as possible for fun.

Important Information

[1]By blind, I mean without looking at the source of the original todo.txt-cli project. I'm working solely from my experiences with the script and experimenting with the functionality while adding things I should probably write as patches and send upstream... I'll wait to finish my version of the project first though.