Listing, filtering and grouping todos
See Showing todos 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 +todo respond to @shelly about project:mobile status:next due:may3
ultralist complete [id]or
ultralist c [id]- complete a todo
ultralist uncomplete [id]or
ultralist uc [id]- un-complete a todo
ultralist complete 35 ultralist c 35 ultralist uc 35
ultralist archive [id]or
ultralist ar [id]- archive a todo
ultralist unarchive [id]or
ultralist uar [id]- unarchive a todo
ultralist ar c- archive all completed todos (a great command to run at the end of the day!)
ultralist ar gc- Garbage collect.
As you use Ultralist, you’ll notice that your IDs continue to increment higher and higher. Running garbage collection will delete all archived todos, thus re-claiming low todo IDs.
ultralist archive 35 ultralist ar 35 ultralist uar 35 ultralist ar c
ultralist prioritize [id]or
ultralist p [id]-prioritize a todo
ultralist unprioritize [id]or
ultralist up [id]- un-prioritize a todo
ultralist prioritize 35 ultralist p 35 ultralist up 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 todo can have many notes. Notes are extra info (links, context, etc).
Adding a note to a todo
Add a note to a todo with the following syntax:
ultralist addnote <todoId> <content>
ultralist an <todoId> <content>
➜ ultralist an 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 todo for the +project 0 adding a note
The above will add a note to the todo 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 editnote <todoId> <noteId> <content>
ultralist en <todoId> <noteId> <content>
➜ ultralist e n 1 0 here is the updated note content. Note edited.
Deleting a note
Use the following syntax:
ultralist deletenote <todoId> <noteId>
ultralist dn <todoId> <noteId>
➜ ultralist dn 1 0 Note deleted.
Handling todo statuses
A todo can have a
status. This allows you to further customize your task management.
In ultralist, a status should be a single lower-case word.
For instance, suppose you like to manage your todos using a now, next, later format.
Adding tasks with a status
You can set a status when adding a todo:
ultralist add this is something I need to do right away status:now ultralist add this is a todo for next week status:next ultralist add this is a someday todo status:later
Listing tasks by status
You can then build powerful aliases around showing todos with a particular status. For instance, to get an idea of things you need to work on now:
ultralist list status:now
Or you can see your whole list, grouped by status:
ultralist list group:status
Removing a todo’s status
Simply set the status of a todo to
ultralist e 33 status:none