NAME

t - Help people finish those damn tasks

VERSION

version 0.14

SYNOPSIS

t [OPTIONS] [ACTION] [ARGS]

Actions:
  add, a       TEXT
  do           ID
  remove, rm   ID
  list, ls     [STRING]
  move, mv     ID NEW
  edit, ed     ID TEXT/REGEX

Options:
  --todo, -t   FILE
  --done, -d   FILE

ACTION

add, a TEXT

add a task to the list

do ID

mark a task as done, and move it to the done file

remove, rm ID

remove a task from the list

list, ls [STRING]

list tasks containing STRING (can be empty)

move, mv ID NEW

move a task from ID to NEW

edit, ed ID TEXT/REGEX

replace the task ID with TEXT/REGEX. if TEXT begins with 's/' it will be treated as a regex (see EXAMPLES).

ACTION

--todo, -t FILE

set todo file (takes precedence on configuration)

--done, -d FILE

set todo file (takes precedence on configuration)

CONFIGURATION

The following environment variables will affect t.pl behaviour:

TODO_FILE

Specifies the path of the todo file. Default ~/.todo

DONE_FILE

Specifies the path of the done file. Default ~/.done

TODO_DEFAULT

Set the default action, this will be used when no action is specified. Default 'help'

EXAMPLES

Add some tasks

$ t add Do something boring
Added task 1
$ t add Do something else
Added task 2

List tasks

$ t ls
1 Do something boring
2 Do something else

Edit a task

$ t ed 1 Do something funny
Replaced task 1

or

$ t ed 1 s/boring/funny/
Replaced task 1

Mark a task as done

$ t do 1
Done task 1

Delete a task

$ t rm 2
Removed task 2

Count tasks

$ t ls | wc -l
0

WEB BOOTSTRAP

If you need to use t on a system where it is not installed (and you don't want to install it there) you can bootstrap t from the web as follows:

$ curl -sL  http://is.gd/kfVKP | perl -

or

$ wget -q http://is.gd/kfVKP -O- | perl -

This method is useful since it downloads and runs t without installing or modifying anything, but it could be a little slow as it have to download t and its dependencies every time it is run.

AUTHOR

Alessandro Ghedini <alexbio@cpan.org>

SEE ALSO

Text::Todo::Simple

LICENSE AND COPYRIGHT

Copyright 2010 Alessandro Ghedini.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.