Skip to content
TODO AF - A todo list for the command line.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A simple task manager for the command line, written in Python.

Install runs on python3. I usually install via brew (on macOS):

brew install python3

Once you have python, you'll need to touch a blank todo file, then tell where this file is. Create a config file in your home folder:

touch ~/.todo.cfg

Edit the file and enter something like the following:

todofile = ~/todo

You can add an alias to .bash_profile like so:

alias todo='$HOME/path/to/python3 $HOME/path/to/todo/'


The main commands are;

  • todo show your todo list.
  • todo add <your task here> add a task to the end of the list.
  • todo delete <task number> delete a task completely.
  • todo complete <task number> move a task to the archive.
You can’t perform that action at this time.