Awesome Open Source
Awesome Open Source


A simple and extensible shell script for managing your todo.txt file.

CI GitHub issues GitHub forks GitHub stars GitHub license Gitter


Read our contributing guide if you're looking to contribute (issues/PRs/etc).



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

OS X / macOS

brew install todo-txt
cp -n /usr/local/opt/todo-txt/todo.cfg ~/.todo.cfg

Note: The -n flag for cp makes sure you do not overwrite an existing file.


From command line

make install
make test

NOTE: Makefile defaults to several default paths for installed files. Adjust to your system:

  • INSTALL_DIR: PATH for executables (default /usr/local/bin)
  • CONFIG_DIR: PATH for todo.txt config
  • BASH_COMPLETION: PATH for autocompletion scripts (default to /etc/bash_completion.d)
make install CONFIG_DIR=/etc INSTALL_DIR=/usr/bin BASH_COMPLETION=/usr/share/bash-completion/completions

Arch Linux (AUR)

Usage [-fhpantvV] [-d todo_config] action [task_number] [task_description]

For example, to add a todo item, you can do: add "THING I NEED TO DO +project @context"

Read about all the possible commands in the USAGE file.

Release History



Code of Conduct

Contributor Code of Conduct. By participating in this project you agree to abide by its terms.


We welcome all contributions. First read our Contributor Code of Conduct and then get started contributing.


GNU General Public License v3.0 © todo.txt org

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (232,627
Linux (16,527
Cli (15,461
Todolist (1,258
Todo (1,249
Todoapp (891
Related Projects