Listing, filtering and grouping todos
See Showing tasks for detailed documentation on how to show your list.
Add a todo by running
ultralist add or
ultralist a, and then filling out the details of the todo.
@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:tomorrow. You can also use
For things due this week, you can use the first 3 letters of the day name. For instance,
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: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
ultralist complete [id]or
ultralist c [id]- complete a todo
ultralist complete [id] --revertor
ultralist c [id] --revert- un-complete a todo
ultralist complete 35 ultralist c 35 ultralist c --revert 35
ultralist archive [id]or
ultralist ar [id]- archive a todo
ultralist archive [id] --revertor
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
ultralist prioritize [id]or
ultralist p [id]-prioritize a todo
ultralist prioritize [id] --revertor
ultralist p [id] --revert- un-prioritize a todo
ultralist prioritize 35 ultralist p 35 ultralist p --revert 35
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!
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
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>
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 all 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
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.