Home

TODO.TXT Command Line Interface

If you’ve got a file called todo.txt on your computer right now, you’re in the right place. Countless software applications and websites can manage your to-do list with all sorts of bells and whistles. But if you don’t want to depend on someone else’s data format or on someone else’s server, a plain text file is the way to go.

Problem is, you don’t want to launch a full-blown text editor every time you need to add an item to your to-do list or mark one that’s already there as complete. With a simple but powerful shell script called todo.sh, you can interact with todo.txt at the command line for quick and easy, Unix-y access.

Downloads

Download the latest stable release for use on your desktop or server.

Documentation

• User Documentation - Find out how to install and use Todo.txt CLI, and get tips and tricks.
• Developer Documentation - Contribute to Todo.txt CLI and build your own custom add-ons.

Mailing List

Get support and ask questions on the mailing list.

Platform Compatibility

todo.sh has been tested on:

• Cygwin for Windows
• Mac OS X 10.4+ Terminal
• Ubuntu 15.10 / sed 4.1.4 / grep 2.5.1 / cat 5.2.1 / wc 5.2.1
• Arch Linux

Let us know if you’re using todo.sh successfully anywhere else.

Quick Links

• Original anemic release by Gina Trapani on 5/11/2006.
• Raised to great heights by brainy and dedicated volunteers.
• Licensed under the GPL
• Todo.sh Add-on Directory
• Known Bugs
• Todo.sh Changelog
• Other Todo.txt Projects