Managing tasks

Learn how to manage tasks using the Ultralist CLI.

Listing, filtering and grouping todos

See Showing tasks for detailed documentation on how to show your list.

Adding todos

Add a todo by running ultralist add or ultralist a, and then filling out the details of the todo.

A +project or @context can be inserted into the todo body. They can only be one word long.

Ultralist expects the due date at the end, if there is a due date.

Due date format

For things due today or tomorrow, you can use due:today and due:tomorrow. You can also use due:tod or due:tom.

For things due this week, you can use the first 3 letters of the day name. For instance, due:mon or due:thu. Ultralist will always look forward. If today is a Wednesday and you specify due:mon, the due date will be for the next Monday.

For specific dates, you can use either due:may2 or due:2may. The month is always lowercase and 3 letters.

ultralist add chat with @bob about +specialProject due:tom
ultralist a +lunch make turkey sandwich priority:true
ultralist a +task respond to @shelly about project:mobile status:next due:may3

Completing/Uncompleting todos

  • ultralist complete [id] or ultralist c [id] - complete a todo
  • ultralist complete [id] --revert or ultralist c [id] --revert - un-complete a todo
ultralist complete 35
ultralist c 35
ultralist c --revert 35

Archiving/Unarchiving todos

  • ultralist archive [id] or ultralist ar [id] - archive a todo
  • ultralist archive [id] --revert or ultralist ar [id] --revert - unarchive a todo
  • ultralist ar c - archive all completed todos (a great command to run at the end of the day!)
ultralist archive 35
ultralist ar 35
ultralist ar --revert 35
ultralist ar c

Prioritizing/Unprioritizing todos

  • ultralist prioritize [id] or ultralist p [id] -prioritize a todo
  • ultralist prioritize [id] --revert or ultralist p [id] --revert - un-prioritize a todo
ultralist prioritize 35
ultralist p 35
ultralist p --revert 35

Deleting todos

ultralist delete [id] or ultralist d [id] will do the job.


ultralist delete 35
ultralist d 35

Be careful! once a todo is deleted, it’s gone forever!

Editing todos

You can edit a todo’s subject or due date The syntax is as follows:

ultralist e [id] <subject> <due:[due]> <status:[status]> <completed:[true|false> <priority:[true|false]> <archived:[true|false]>

Editing a todo’s subject

When if you do not include due:[date], then just the subject will be edited.


ultralist e 3 chat with @bob

The above will edit just the todo’s subject, and leave the due date alone.

Editing a todo’s due date

If you only pass due:[date], the todo’s due date will be updated, and the subject will remain the same.

ultralist e 3 due:tom

The above will set the todo item with id of 3's due date to tomorrow, and it will leave the subject alone.

Removing a todo’s due date

You can also say due:none to un-set an existing due date.


ultralist e 3 due:none

Notes management

Each task can have many notes. Notes are extra info (links, context, etc).

Adding a note to a task

Add a note to a task with the following syntax:

ultralist add note <todoId> <content> or ultralist a n <todoId> <content>

➜ ultralist a n 1 here is a note
Note added.

Then you can list your todos with notes by using ultralist list --notes

➜ ultralist l --notes

1    [ ]  tomorrow    some important task for the +project
  0                     adding a note

The above will add a note to the task with an id of 0.

Editing a note

When you edit a note, you replace all of the contents of the note.

Use the following syntax:

ultralist edit note <todoId> <noteId> <content>


ultralist e n <todoId> <noteId> <content>


➜ ultralist e n 1 0 here is the updated note content.
Note edited.

Deleting a note

Use the following syntax:

ultralist delete note <todoId> <noteId>


ultralist d n <todoId> <noteId>


➜ ultralist d n 1 0
Note deleted.