Task

Task is an open source, command-line, TODO list manager.

Here you will find information on how to acquire, build, configure, use and become proficient with the task program.

More documents are being written, and will be added here.

Alternatively, watch the task movie which illustrates many of task's features.

Get the Latest Stable Release

Source:	task-1.6.0.tar.gz
Mac OS X 10.5 (Leopard) Intel-only:	task-1.6.0.pkg
Debian: (Thanks to Richard Querin):	task_1.6.0-1_i386.deb
Red Hat: (Thanks to Federico Hernandez):	task-1.6.0-1.i386.rpm
Git - get the whole source and history:	http://github.com/pbeckingham/task

New in version 1.6.0 (?)

Added support for new "append" command that adds more description text to an existing task.
Added support for the "weekdays" recurrence, which means a task can recur five times a week, and not on weekends (thanks to Chris Pride).
UTF8 text is now supported in task project names, tags and descriptions.
Fixed bug that caused the y/n confirmation on task deletion to ignore the Enter key and fail to re-prompt (thanks to Bruce Dillahunty).
When the "echo.command" configuration variable is set to "yes", it causes commands that modify tasks to display which task was affected (thanks to Bruce Dillahunty).
A task can now be annotated with the command "task annotate ...", and a timestamped annotation will appear in reports.
A 'description_only' column is now available for use in custom reports, and it excludes annotations.
A task can now be upgraded to a recurring task by adding a recurrence frequency, a due date, and an optional until date.
When a recurring task is modified, all other instances of the recurring task are also modified.
Custom reports now support user-specified column labels (thanks to T. Charles Yun).
Task can now import tasks from a variety of data formats, including task export files from versions 1.4.3 and earlier, versions 1.5.0 and later, todo.sh 2.x, CSV, plain text and task command line. See online docs for full details.
Export was including 'id' in the column header even though it was not included in the data.
The task file format has changed slightly. Please back up your task data files before upgrading to 1.6.0.
Added new column 'recurrence_indicator' that displays an 'R' if the task is a recurring task. This column can be added to any custom report.
Added new column 'tag_indicator' that displays a '+' if the task has any tags. This column can be added to any custom report.

(Find out what was new in prior versions)

Troubleshooting

Task has been built from source and tested in the following environments:

OS X 10.4 Tiger
OS X 10.5 Leopard
Fedora Core 8
Fedora Core 9
Fedora Core 10
Ubuntu 7 Feisty Fawn
Ubuntu 8 Hardy Heron
Ubuntu 8.10 Intrepid Ibex
Solaris 10
Cygwin 1.5.25-14

If you have difficulties building task, have found a bug, have a suggestion for improvement, or a feature request, please send mail to task@beckingham.net.

Take a look at the troubleshooting guide for tips and workarounds to problems.