Skip to content
Dylan Kinnett edited this page Mar 17, 2014 · 1 revision
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