Skip to content
Python port of Gina Trapani's popular todo.txt-cli project
Python Shell
Find file
Latest commit 4da843d Feb 4, 2013 @sigmavirus24 Merge pull request #3 from kalafut/master
Fix typo
Failed to load latest commit information.
docs @ 7583395 Fix addm on python 3000. Update docs. May 25, 2012
sample_addons No need for an file. May 23, 2012
tests Modularize to make it easier to test. Jun 1, 2012
utils Update More @usage conversions. Apr 12, 2012
.gitattributes Add last of changes from optgit. Feb 16, 2012
.gitignore Update .gitignore. May 25, 2012
.gitmodules Add wiki pages as documentation. May 18, 2012
HISTORY.rst Get ready for version 0.3. Jun 1, 2012
LICENSE Finally a working May 26, 2012
NOTES.rst Nope. Not working. May 21, 2012
README.rst Fix execution of bash add-ons. May 26, 2012 Check that is not already installed. Sep 21, 2011 Make it easier to visually grep the test output. Feb 29, 2012 Get ready for version 0.3. Jun 2, 2012 Fixed minor typo Feb 4, 2013


Build Status

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


This only requires GitPython if you want to have 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 script.

Be sure to run ./ -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 from PyPi like so:

$ pip install

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/'


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.
Something went wrong with that request. Please try again.