Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Clone this wiki locally
Usage: todo.sh [-fhpqvV] [-d todo_config] action [task_number] [task_description]
Actions: add "THING I NEED TO DO +project @context" a "THING I NEED TO DO +project @context" Adds THING I NEED TO DO to your todo.txt file on its own line. Project and context notation optional. Quotes optional.
addto DEST "TEXT TO ADD" Adds a line of text to any file located in the todo.txt directory. For example, addto inbox.txt "decide about vacation"
append NUMBER "TEXT TO APPEND" app NUMBER "TEXT TO APPEND" Adds TEXT TO APPEND to the end of the todo on line NUMBER. Quotes optional.
archive Moves done items from todo.txt to done.txt and removes blank lines.
del NUMBER [TERM] rm NUMBER [TERM] Deletes the item on line NUMBER in todo.txt. If term specified, deletes only the term from the line.
depri NUMBER dp NUMBER Deprioritizes (removes the priority) from the item on line NUMBER in todo.txt.
do NUMBER Marks item on line NUMBER as done in todo.txt.
list [TERM...] ls [TERM...] Displays all todo's that contain TERM(s) sorted by priority with line numbers. If no TERM specified, lists entire todo.txt.
listall [TERM...] lsa [TERM...] Displays all the lines in todo.txt AND done.txt that contain TERM(s) sorted by priority with line numbers. If no TERM specified, lists entire todo.txt AND done.txt concatenated and sorted.
listcon lsc Lists all the task contexts that start with the @ sign in todo.txt.
listfile SRC [TERM...] lf SRC [TERM...] Displays all the lines in SRC file located in the todo.txt directory, sorted by priority with line numbers. If TERM specified, lists all lines that contain TERM in SRC file.
listpri [PRIORITY] lsp [PRIORITY] Displays all items prioritized PRIORITY. If no PRIORITY specified, lists all prioritized items.
listproj lsprj Lists all the projects that start with the + sign in todo.txt.
move NUMBER DEST [SRC] mv NUMBER DEST [SRC] Moves a line from source text file (SRC) to destination text file (DEST). Both source and destination file must be located in the directory defined in the configuration directory. When SRC is not defined it's by default todo.txt.
prepend NUMBER "TEXT TO PREPEND" prep NUMBER "TEXT TO PREPEND" Adds TEXT TO PREPEND to the beginning of the todo on line NUMBER. Quotes optional.
pri NUMBER PRIORITY p NUMBER PRIORITY Adds PRIORITY to todo on line NUMBER. If the item is already prioritized, replaces current priority with new PRIORITY. PRIORITY must be an uppercase letter between A and Z.
replace NUMBER "UPDATED TODO" Replaces todo on line NUMBER with UPDATED TODO.
report Adds the number of open todo's and closed done's to report.txt.
Options: -d CONFIG_FILE Use a configuration file other than the default ~/todo.cfg -f Forces actions without confirmation or interactive input -h Display this help message -p Plain mode turns off colors -a Don't auto-archive tasks automatically on completion -n Don't preserve line numbers; automatically remove blank lines on task deletion -v Verbose mode turns on confirmation messages -V Displays version, license and credits