LinuxCommandLibrary

todo

Manage and track todo list items

TLDR

List startable tasks

$ todo list --startable
copy

Add a new task to the work list
$ todo new [thing_to_do] --list [work]
copy

Add a location to a task with a given ID
$ todo edit --location [location_name] [task_id]
copy

Show details about a task
$ todo show [task_id]
copy

Mark tasks with the specified IDs as completed
$ todo done [task_id1 task_id2 ...]
copy

Delete a task
$ todo delete [task_id]
copy

Delete done tasks and reset the IDs of the remaining tasks
$ todo flush
copy

SYNOPSIS

todo [options] [task description]

PARAMETERS

-a, --add
    Adds a new task to the todo list. The task description follows this option.

-l, --list
    Lists all the tasks in the todo list, showing their index and status.

-d, --done
    Marks the task at the specified index as completed.

-r, --remove
    Removes the task at the specified index from the todo list.

-h, --help
    Displays the help message with command usage information.

DESCRIPTION

The todo command is a basic utility designed for managing a simple todo list directly from the Linux command line. It provides functionalities to add, list, mark as done, and remove tasks. It is a lightweight solution that stores todo items in a plain text file (~/.todo) by default, making it easily editable with any text editor. The command prioritizes ease of use and simplicity, offering a fast way to keep track of tasks without the overhead of more complex task management systems.
It's important to note that 'todo' might refer to different implementations depending on the distribution or installed packages. This JSON description covers the generally available implementation found widely used on Linux.

CAVEATS

The 'todo' command's functionality is limited to basic task management. It doesn't support features like due dates, priorities, or task categories natively. The data is stored in a plain text file, making it vulnerable to corruption if not handled carefully or if the file is accidentally edited incorrectly.

STORAGE

By default, todo stores items into a file named '.todo' located in the user's home directory (~/.todo). The format is a simple list, with each line representing a task. The status of the task (done or not done) is usually indicated with some kind of a character such as 'x'.

SEE ALSO

task(1)

Copied to clipboard